DNS Lookup

DNS Lookup

What it does

DNS Lookup lets you query a hostname or IP address and get the resolver’s answer back as structured DNS data. Send a host and, optionally, a record type of A, AAAA, MX, NS, TXT, CNAME, or PTR.

The response includes a data object with the queried host, requested type, and a status value of OK, NXDOMAIN, NODATA, or ERROR. Depending on the record type, the payload also returns addresses for A and AAAA records, mx entries with preference and exchange, names for NS or CNAME, txt strings for TXT records, and ptr target names for reverse lookups.

Use DNS Lookup when you need to verify that a domain resolves, inspect mail routing, check TXT records for SPF or verification setups, or confirm reverse DNS for an IP address. It’s a straightforward way to add DNS inspection to onboarding flows, diagnostics, monitoring, or support tooling without parsing raw resolver output.

The response keeps the record-type-specific fields separated, so you only read the data that applies to the query you made.

About this endpoint

What it does

Looks up DNS records for the specified host and returns a JSON object containing the DNS answer for the requested record type. The response includes the queried host, the requested type, a status, and any record-type-specific fields that apply.

Query Parameter(s)

Attribute	Type	Mandatory	Description
host	String	Yes	Hostname or IP address to look up.
type	ENUM	No	DNS record type to query. Allowed values: `A`, `AAAA`, `MX`, `NS`, `TXT`, `CNAME`, `PTR`.<br>Default: `A`.

Response

Returns a JSON object with a data object field. The data object contains the queried host and type, a status, and type-specific record fields such as addresses, mx, names, ptr, or txt when relevant.

Attribute	Type	Mandatory	Description
data	Object	Yes	DNS answer for the requested host and type. Contains `status`, `host`, and `type`, plus only the fields relevant to the requested record type.

Notes

Only fields relevant to the requested record type are populated; all other record-type fields are omitted. The status field can be OK, NXDOMAIN, NODATA, or ERROR; ERROR is noted as batch-row only in the schema.

Query parameters

Name

Type

Description

hostREQUIRED

string

—

typeOPTIONAL

string

A · AAAA · MX · NS · TXT · …

—

DEFAULT A

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Query Parameter(s)

Response

Notes

Query parameters

Errors any endpoint can return