Loading
Loading
Instant and precise access to DNS records (A, AAAA, MX, NS, SOA, SPF, TXT, CNAME) for any hostname. Designed for DNS troubleshooting, domain management, and network performance optimization.
The DNS Lookup API provides comprehensive DNS intelligence including A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME records. Perfect for DNS troubleshooting, MX validation, domain configuration verification, and network monitoring.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters. At least one of host-name or ipAddress must be provided.
host-nameoptionalStringHostname or URL whose DNS records required.
ipAddressoptionalStringThe IP address for requested DNS's PTR record.
typerequiredArrayA comma-separated list of DNS record types for lookup. The values can be A, AAAA, MX, NS, SOA, SPF, TXT, CNAME, or all. When ipAddress is provided, type must be "all".
A successful request returns a 200 OK response with a JSON object containing DNS records. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.
statusIndicates whether the query was processed successfully (true or false).
queryTimeTime at which the query was made. (Format: YYYY-MM-DD HH:mm:ss)
domainNameQueried domain.
domainRegisteredIndicates whether the domain is registered (true) or not (false).
dnsTypesDNS record types included in the response.
dnsRecordsList of DNS records, with different formats depending on the record type.
Each A or AAAA record object contains the following additional fields:
nameName of the queried domain.
typeDNS type code (e.g., 1 for A, 28 for AAAA).
dnsTypeDNS type as a string (e.g., "A", "AAAA").
ttlTime to live in seconds.
rawTextRaw (un-parsed) DNS record text.
rRsetTypeIndicates the resource record set type.
addressIPv4 or IPv6 address for A or AAAA records respectively.
Each CNAME record object contains the following additional fields:
nameName of the queried domain.
typeDNS type code (e.g., 1 for A, 28 for AAAA).
dnsTypeDNS type as a string (e.g., "A", "AAAA").
ttlTime to live in seconds.
rawTextRaw (un-parsed) DNS record text.
rRsetTypeIndicates the resource record set type.
targetHost to which this domain points.
Each MX record object contains the following additional fields:
nameName of the queried domain.
typeDNS type code (e.g., 1 for A, 28 for AAAA).
dnsTypeDNS type as a string (e.g., "A", "AAAA").
ttlTime to live in seconds.
rawTextRaw (un-parsed) DNS record text.
rRsetTypeIndicates the resource record set type.
targetTargeted mail service provider.
priorityPriority level associated with the mail server.
Each NS record object contains the following additional fields:
nameName of the queried domain.
typeDNS type code (e.g., 1 for A, 28 for AAAA).
dnsTypeDNS type as a string (e.g., "A", "AAAA").
ttlTime to live in seconds.
rawTextRaw (un-parsed) DNS record text.
rRsetTypeIndicates the resource record set type.
singleNameName server for that particular domain.
Each SOA record object contains the following additional fields:
nameName of the queried domain.
typeDNS type code (e.g., 1 for A, 28 for AAAA).
dnsTypeDNS type as a string (e.g., "A", "AAAA").
ttlTime to live in seconds.
rawTextRaw (un-parsed) DNS record text.
rRsetTypeIndicates the resource record set type.
adminAdministrative contact email for SOA records.
hostPrimary name server for SOA records.
expireExpiry time for SOA records.
minimumThe minimum TTL for SOA records.
refreshIndicates the refresh interval for SOA records.
retryThe retry interval for SOA records.
serialThe serial number for SOA records.
Each SPF or TXT record object contains the following additional fields:
nameName of the queried domain.
typeDNS type code (e.g., 1 for A, 28 for AAAA).
dnsTypeDNS type as a string (e.g., "A", "AAAA").
ttlTime to live in seconds.
rawTextRaw (un-parsed) DNS record text.
rRsetTypeIndicates the resource record set type.
stringsList containing the verification strings.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
please pass correct parameters
Entered Domain does not exist: <HOSTNAME>
Unable to fetch dns records. Please try after some time. [For Technical Support email at: support@whoisfreaks.com]
Service is unavailable.
Request is timed-out.