This service offers a REST API allowing to perform DNS queries over HTTP from multiple locations worldwide, and to get reverse PTR records for both IPv4 and IPv6 addresses. It outputs JSON-encoded DNS responses.

There is no rate limit of any sort at the moment, but we ask you to use the service on a reasonable basis (i.e. : no repeated automated queries).

We maintain a test domain hosting some seldom used resource record types.

Making queries

We provide a list of all available nodes in JSON format : nodes.json

None of the nodes listed should perform NXDOMAIN hijacking.

If you notice such behaviour with any of the listed nodes, please contact us.

Getting Resources Records

URL Scheme : /node/domain/querytype

List of commands

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

Getting Reverse PTR Records (for both IPv4 and IPv6 addresses)

URL Scheme : /node/x/ip

List of commands

ActionExample
Get reverse (PTR) record from IPv4 addresseshttp://www.dns-lg.com/ch01/x/193.0.6.139
Get reverse (PTR) record from IPv6 addresseshttp://www.dns-lg.com/ch01/x/2001:67c:2e8:22::c100:68b

JSON Output Schema

The output is a JSON object containing the following arrays, representing the appropriate sections of DNS packets :

Question section

Answer, Authority, Additional sections

Errors

Client Errors

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

HTTP ErrorCodeMessage
400401Input string could not be parsed
400402Input string is not a well-formed domain name
400403Input string is not a valid IP address
400404Invalid DNS query type

Server Errors

When the DNS server cannot be reached or returns an error, the server returns an HTTP 500 Error (Internal Server Error), along with a JSON-encoded error message.

HTTP ErrorCodeMessage
500501DNS server could not be reached
500502The name server encountered an internal failure while processing this request (SERVFAIL)
500503Some name that ought to exist, does not exist (NXDOMAIN)
500505The name server refuses to perform the specified operation for policy or security reasons (REFUSED)

This site is valid HTML5 and CSS 3