IMPORTANT INFORMATION

The public API has been permanently shut down on December 28th, 2015.

To continue using StatDNS API after this date, please spin up your own instance.

This is a REST API allowing to perform DNS queries over HTTP, and to get reverse PTR records for both IPv4 and IPv6 addresses. It outputs JSON-encoded DNS responses, and supports both Cross-origin resource sharing (CORS) and JSONP. It can be useful in server-side environments where you cannot perform DNS queries locally, for client-side Web Applications (including Web browser extensions), and for DNS operators.

There is no rate limit of any sort at the moment, and the service is free for everyone to use.

The API powering this site (RRDA) is open source and can be downloaded here or on GitHub .

Errors

When incorrect input is entered, the server returns an HTTP 400 Error (Bad Request), along with a JSON-encoded error message.

When a malformed domain name is entered, the following error message is returned:

{"error":{"code":400,"message":"ERROR: Input string is not a well-formed domain name."}}

When an invalid IP address is entered, the following error message is returned:

{"error":{"code":400,"message":"ERROR: Input string is not a valid IP address."}}

Getting Resources Records

ActionCommand
Get Host Address (A records)http://api.statdns.com/statdns.net/a
Get IPv6 Host Address (AAAA records)http://api.statdns.com/statdns.net/aaaa
Get Certificate (CERT records)http://api.statdns.com/statdns.net/cert
Get Canonical Name (CNAME records)http://api.statdns.com/cname.statdns.net/cname
Get DHCP Identifier (DHCID records)http://api.statdns.com/statdns.net/dhcid
Get DNSSEC Lookaside Validation record (DLV records)http://api.statdns.com/statdns.net/dlv
Get Delegation name (DNAME records)http://api.statdns.com/dname.statdns.net/dname
Get DNS Key record (DNSKEY records)http://api.statdns.com/statdns.net/dnskey
Get Delegation Signer (DS records)http://api.statdns.com/statdns.net/ds
Get Host Information (HINFO records)http://api.statdns.com/statdns.net/hinfo
Get Host Identity Protocol (HIP records)http://api.statdns.com/statdns.net/hip
Get Key eXchanger record (KX records)http://api.statdns.com/statdns.net/kx
Get Location record (LOC records)http://api.statdns.com/statdns.net/loc
Get Mail Exchange record (MX records)http://api.statdns.com/statdns.net/mx
Get Name Authority Pointer (NAPTR records)http://api.statdns.com/statdns.net/naptr
Get Name Servers (NS records)http://api.statdns.com/statdns.net/ns
Get Next-Secure record (NSEC records)http://api.statdns.com/statdns.net/nsec
Get NSEC record version 3 (NSEC3 records)http://api.statdns.com/hashvalue.statdns.net/nsec3
Get NSEC3 parameters (NSEC3PARAM records)http://api.statdns.com/statdns.net/nsec3param
Get Option record (OPT records)http://api.statdns.com/statdns.net/opt
Get Pointer record (PTR records)http://api.statdns.com/8.8.8.8.in-addr.arpa/ptr
Get Resource Records Signature (RRSIG records)http://api.statdns.com/statdns.net/rrsig
Get Start of Authority (SOA record)http://api.statdns.com/statdns.net/soa
Get Sender Policy Framework (SPF records)http://api.statdns.com/statdns.net/spf
Get Service Locator (SRV records)http://api.statdns.com/_sip._tcp.statdns.net/srv
Get SSH Public Key Fingerprint (SSHFP records)http://api.statdns.com/statdns.net/sshfp
Get DNSSEC Trust Authorities (TA records)http://api.statdns.com/statdns.net/ta
Get Trust Anchor LINK (TALINK records)http://api.statdns.com/statdns.net/talink
Get TLSA recordshttp://api.statdns.com/_443._tcp.www.statdns.net/tlsa
Get Text record (TXT records)http://api.statdns.com/statdns.net/txt

Getting Reverse PTR Records

ActionCommand
Get reverse (PTR) record from IPv4 addresseshttp://api.statdns.com/x/193.0.6.139
Get reverse (PTR) record from IPv6 addresseshttp://api.statdns.com/x/2001:67c:2e8:22::c100:68b