Public API

Keyless, CORS-enabled, JSON. Use it in a script, a status page, or a shell alias.

Your connection

curl -s https://ipcanary.org/api/whoami

Returns the connecting address, ASN and operator, geolocation estimate, TLS and HTTP details, handshake RTT and our network classification.

Address lookup

curl -s https://ipcanary.org/api/ip/8.8.8.8

Resolves any IPv4 or IPv6 address to its announcing ASN, BGP prefix, registry, allocation date and classification. Cached for one hour.

ASN detail

curl -s https://ipcanary.org/api/asn/13335

Operator name, registry country, registry and allocation date. Cached for one day.

DNS over HTTPS

curl -s "https://ipcanary.org/api/dns?name=example.com&type=MX"

Proxies a DNS-over-HTTPS query and returns the standard JSON response.

Request headers

curl -s https://ipcanary.org/api/headers

Every header the edge received, useful for debugging what a client or proxy is actually sending.

Fair use

No key, no quota published, no logging of query contents. If you are going to hammer it, cache on your side, and expect rate limiting to appear if it becomes necessary.