Current DNS state for an FQDN, in one call.

Pass an FQDN and one or more record types. Get back the current authoritative response from Deepinfo's hosted resolver. Comma-separated types in a single call.

WHAT THIS API RETURNS

Live DNS state, across record types.

The DNS Lookup API returns the current authoritative DNS response for an FQDN. Pass one or more record types comma-separated, and the API returns the response for each from Deepinfo's hosted resolver fleet.

Each response carries the records, the responding name servers, and the check timestamp. The hosted resolver pool is geographically distributed; results reflect current authoritative state at query time.

Use this when you need fresh DNS state instead of indexed state. Pair with DNS History when you also need the historical observation window. The response includes the FQDN, the resolved records, the responding servers, and the check timestamp.

REQUEST

One endpoint, two parameters.

Endpoint:

GET https://api.deepinfo.com/v1/lookup/dns?domain={domain}&type={type}

Parameters:

Name In Type Required Description
domain query string Yes A fully qualified domain name such as www.deepinfo.com.
type query string Yes DNS record type or comma-separated list. Supported: A, AAAA, MX, NS, SOA, TXT, CNAME.

Authentication is by API token in the request header. See docs.deepinfo.com for the full request reference.

SAMPLE RESPONSE

See what the API returns.

Real response structure for the Current DNS state for an FQDN, in one call endpoint. Field coverage may vary based on query parameters and data availability.

JSON RESPONSE
{
  "fqdn": "www.deepinfo.com",
  "requested_types": ["A", "MX"],
  "responses": [
    {"type": "A",  "value": "203.0.113.42", "ttl": 300},
    {"type": "MX", "value": "alt1.aspmx.l.google.com", "priority": 10, "ttl": 3600},
    {"type": "MX", "value": "alt2.aspmx.l.google.com", "priority": 10, "ttl": 3600}
  ],
  "servers": ["ns-cloud-a1.googledomains.com", "ns-cloud-a2.googledomains.com"],
  "check_date": "2026-05-02T08:30:11Z"
}
STRUCTURED VIEW
Fields
Fqdn
www.deepinfo.com
Check date
2026-05-02T08:30:11Z
Requested types
Count
2
Items
A, MX
Responses
Count
3
First type
A
First value
203.0.113.42
First ttl
300
Servers
Count
2
Items
ns-cloud-a1.googledomains.com, ns-cloud-a2.googledomains.com

Sample response shown. Real responses depend on query parameters, data availability, and API version. Talk to us for full schema documentation.

“Live DNS lookups in our SOAR enrichment workflow used to depend on whichever resolver was reachable. Authoritative responses through a single API cut intermittent failures and gave us a consistent shape across record types.”

— Detection Engineer, Managed Security Services Provider
GET STARTED

Run a sample call, or batch lookup your FQDN set.

We'll set up token access and answer schema questions on a call.

Talk to us Browse API docs