ipaddress.im

API

The same answers as JSON, without a key.

From a terminal

Requesting the site root with curl returns your address as plain text and nothing else, so it composes in a shell script.

$ curl ipaddress.im
203.0.113.42

Endpoint

GET/api/plain

Your address as plain text, with a trailing newline. Nothing else.

curl ipaddress.im
GET/api/ip

Your address with its routing origin and registry delegation, as JSON.

curl -s https://ipaddress.im/api/ip
GET/api/ip/{address}

The same record for any IPv4 or IPv6 address.

curl -s https://ipaddress.im/api/ip/8.8.8.8
GET/api/asn/{asn}

Holder, registry allocation and announced prefixes for an AS number.

curl -s https://ipaddress.im/api/asn/15169
GET/api/dns?host={hostname}&type={type}

DNS records, resolved live. Omit type for every supported type.

curl -s 'https://ipaddress.im/api/dns?host=example.com&type=MX'
GET/api/reverse-dns?ip={address}

PTR names for an address, with forward confirmation.

curl -s 'https://ipaddress.im/api/reverse-dns?ip=8.8.8.8'
GET/api/whois?q={query}

RDAP record and raw WHOIS text for a domain, address or AS number.

curl -s 'https://ipaddress.im/api/whois?q=example.com'
GET/api/blacklist?ip={address}

DNSBL status per list, with each list's own return code. Omit ip for your own.

curl -s 'https://ipaddress.im/api/blacklist?ip=8.8.8.8'
POST/api/ports

Open ports on your own address. There is no way to name another target.

curl -sX POST https://ipaddress.im/api/ports
GET/api/status

Dataset freshness and record counts. Used by the container healthcheck.

curl -s https://ipaddress.im/api/status
Fair useThere is no key and no quota. Please cache what you fetch and keep bulk work to a rate a small server can serve.