API Documentation
Public REST API for IP geolocation, network tools and security verification.
https://mon-ip.devAPI Key
The API is publicly accessible without authentication. For higher limits, create an account and generate an API key from your dashboard. Open the dashboard →
Pass your key via the Authorization header:
Rate limiting
Requests are limited based on your access level. If exceeded, the API returns a 429 Too Many Requests error.
Each response includes headers to track your usage:
X-RateLimit-LimitMaximum allowed requests per hourX-RateLimit-RemainingRemaining requests in the current windowX-RateLimit-ResetUNIX timestamp of counter resetError codes
In case of error, the response contains an error field with a descriptive message.
Terminal (curl)
No key, no parameters: query the site root directly from curl, wget, HTTPie or PowerShell. Responses are never cached and CORS is allowed.
/ Returns your public IP address as plain text followed by a newline when the request comes from a command-line client (curl, wget, HTTPie, PowerShell…). The /ip path returns the same response from any client.
/json Geolocation and network details for your IP, as indented JSON (readable straight in the terminal).
ipstringIP address looked upipTypestringVersion: IPv4 or IPv6ipClassstringIP class (A, B, C)hostnamestringReverse DNScountrystringCountrycountryCodestringISO 3166-1 country code (2 letters)citystringCitycontinentstringContinentpostalCodestringPostal code (if known)latitudenumberApproximate latitudelongitudenumberApproximate longitudetimezonestringTime zone (IANA)providerstringInternet provider or operatorasnnumberAutonomous system number (AS)/{ip}/json The same details for any IPv4 or IPv6 address given in the path. Missing fields are omitted.
iprequiredIPv4 or IPv6 address to look up, in the path (e.g. 8.8.8.8)IP & Geolocation
/api/v1/json Returns geolocation, ISP and security information for the client's IP.
ipstringIPv4 addressipv6stringIPv6 address (if available)hostnamestringReverse DNStypestringIP type (Residential, Business, etc.)classstringIP class (A, B, C)locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCodenetworkobjectprovider, asnsecurityobjectSecurity indicators (proxy, VPN, Tor, etc.)/api/v1/ipv6 Detects whether the client is connecting via IPv4 or IPv6.
ipstringClient IP addressis_ipv4booleantrue if IPv4is_ipv6booleantrue if native IPv6protocolstring"IPv4" or "IPv6"timestampstringISO 8601 timestampDNS & Domains
/api/v1/dns Performs a DNS resolution for a given record type.
hostrequiredDomain name (e.g., google.com)record_typerequiredType: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRVhoststringQueried domainrecordsarrayList of records: record_type, value, ttl/api/v1/whois Returns WHOIS information for a domain or IP.
targetrequiredDomain or IP (e.g., google.com)targetstringQueried targetrawstringRaw WHOIS responseparsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnsseccachedbooleantrue if result is from cache/api/v1/ssl Checks the SSL/TLS certificate of a domain by connecting to port 443.
hostrequiredDomain name (e.g., google.com)hoststringTested domainvalidbooleantrue if certificate is validdays_remainingnumberDays until expirationsubjectstringSubject (CN)issuerstringIssuer (CN)issuer_orgstringIssuer organizationvalid_fromstringStart date (ISO 8601)valid_tostringExpiration date (ISO 8601)serialstringSerial numberfingerprintstringSHA-256 fingerprintprotocolstringTLS protocol (e.g., TLSv1.3)bitsnumber | nullKey size in bitsalt_namesstring[]Subject alternative names (SAN)Security
/api/v1/blacklist Checks if an IPv4 address is listed in 8 DNS blacklists.
iprequiredIPv4 address (e.g., 8.8.8.8)ipstringTested IPtotalnumberNumber of lists testedlistednumberNumber of lists where IP appearscleanbooleantrue if IP is not on any listresultsarrayDetail per list: name, zone, listedNetwork
/api/v1/ping SSESends ICMP packets and returns results in real-time via Server-Sent Events.
hostrequiredHost or IP (e.g., 8.8.8.8)countoptionalNumber of packets (default: 4)starthost, resolved_ipreplyseq, ip, time_ms, ttltimeoutseqdonealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_mserrormessage/api/v1/traceroute SSETraces the network path to a host in real-time via Server-Sent Events.
hostrequiredHost or IP (e.g., google.com)starthost, resolved_iphophop, ip, hostname, rtt_msdonetotal_hops, reachederrormessageEventSource / curl -NGet your IP from the terminal
Use our API or the curl command to integrate mon-ip.dev into your scripts.