Network & DNS
GET
/api/v1/reverse-dns-lookupReverse DNS Lookup
PTR lookup: the hostnames registered for an IPv4 or IPv6 address. An empty hostnames list means no PTR record is registered; a resolver failure is returned as an error, never as an empty list.
Cost: 1 credit per request, out of 300 per day.
| Parameter | Type | Required | Description |
|---|---|---|---|
ip | string | Yes | IPv4 or IPv6 address to look up. Private, loopback and link-local addresses are rejected because they have no public reverse DNS. |
resolver | string | No | Which resolver to query: an ip from the DNS Propagation Checker's named list (8.8.8.8 Google, 1.1.1.1 Cloudflare, 9.9.9.9 Quad9, 208.67.222.222 OpenDNS, 64.6.64.6 Verisign, 94.140.14.14 AdGuard, 223.5.5.5 Alibaba, 4.2.2.1 Level3), or "system" for this server's own default resolver. Omitted or unrecognized defaults to "system". The response reports the resolver used, or null for "system". |
Example request
curl "https://netsh.io/api/v1/reverse-dns-lookup?ip=1.1.1.1&resolver=1.1.1.1&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "ip": "1.1.1.1", "hostnames": ["one.one.one.one"], "resolver": { "name": "Cloudflare", "ip": "1.1.1.1" } }, "meta": { "tool": "reverse-dns-lookup", "version": "v1" } }