DNS Batch Lookup — resolve up to 25 hosts

DNS Batch Lookup API

Hosted on ApyHub

What it does

DNS Batch Lookup lets you send up to 25 host lookups in one request and get a per-row DNS answer back. Use it when you need to resolve domains or IPs for PTR lookups without making one network call at a time.

Each query in the queries array accepts a host and an optional type. Supported record types are A, AAAA, MX, NS, TXT, CNAME, and PTR; omit type to query A. The response returns data.results, where every result includes status, host, and type. Depending on the record type, you may also get addresses, names, txt, mx, or ptr. For failed rows, status is ERROR and an error field explains the failure.

The status field helps you distinguish between a valid answer (OK), a non-existent name (NXDOMAIN), an existing name with no records of the requested type (NODATA), and row-level batch failures (ERROR). That makes it straightforward to normalize DNS checks in onboarding flows, security tooling, inventory audits, or infrastructure monitoring.

If you need to validate multiple domains, inspect mail exchanger records, or reverse-resolve IP addresses in bulk, DNS Batch Lookup keeps the response structured and easy to process.

curl -X POST "http://localhost:8080/apyhub/mono-go-dns-batch-lookup" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "queries": [ { "host": "google.com" } ] }'

What you'll get back

Returns a JSON object with a data object. Inside data, results is an array of DNS lookup results; each item includes status, host, and type, and may also include record-specific fields like addresses, mx, names, ptr, txt, or error depending on the query.

{
  "data": {
    "results": [
      {
        "status": "OK",
        "host": "apyhub.com",
        "type": "A",
        "addresses": [
          "188.114.96.3",
          "188.114.97.3"
        ]
      },
      {
        "status": "OK",
        "host": "google.com",
        "type": "A",
        "addresses": [
          "172.217.22.14"
        ]
      }
    ]
  }
}

About this endpoint

What it does

Performs up to 25 DNS lookups in a single request. You send a list of queries, and the response returns a per-query result with the resolved records and a status for each row.

Request Body

Parameter	Type	Mandatory	Description
queries	Object Array	Yes	List of DNS lookup requests. Max 25 items.
queries[].host	String	Yes	Domain, FQDN, or IP address for PTR lookups.
queries[].type	ENUM	No	Record type to query. Allowed values: `A`, `AAAA`, `MX`, `NS`, `TXT`, `CNAME`, `PTR`. Default: `A`. Omit for `A`.

Response

Returns a JSON object with a data object field. data contains a results array; each item is a DNS answer object for one requested query, including the queried host, the queried type, a status, and record-specific fields when applicable.

Parameter	Type	Mandatory	Description
data	Object	No	Wrapper object containing the lookup results.
data.results	Object Array	No	Array of per-query DNS answer objects. Each item includes `status`, `host`, and `type`, plus only the record fields relevant to the queried type.
data.results[].status	ENUM	No	Result status for the row. Allowed values: `OK`, `NXDOMAIN`, `NODATA`, `ERROR`. `OK` means at least one record returned; `NXDOMAIN` means the DNS name does not exist; `NODATA` means the name exists but has no records of the requested type; `ERROR` is used for batch-row failures.
data.results[].host	String	No	Queried host, or IP address for PTR.
data.results[].type	ENUM	No	Queried record type. Allowed values: `A`, `AAAA`, `MX`, `NS`, `TXT`, `CNAME`, `PTR`.
data.results[].addresses	String Array	No	IPv4 (`A`) or IPv6 (`AAAA`) addresses.
data.results[].names	String Array	No	Hostnames for `NS` or `CNAME` answers.
data.results[].mx	Object Array	No	MX records returned for the query. Each item is one MX resource record.
data.results[].mx[].preference	Integer	No	MX preference. Lower values have higher priority.
data.results[].mx[].exchange	String	No	Mail exchanger hostname, often returned with a trailing dot.
data.results[].ptr	String Array	No	PTR target names for reverse DNS lookups.
data.results[].txt	String Array	No	TXT RDATA strings. One element is returned per TXT record, per Go `net.Resolver`.
data.results[].error	String	No	Present when `status` is `ERROR`, typically for resolver or validation failures for that row.

Notes

The batch is limited to 25 queries per request. The response is row-oriented: only the fields relevant to each query's type are populated, and the other record fields are omitted.

Body

Name

Type

Description

bodyREQUIRED

object

—

DNS Batch Lookup API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Notes

Body

Errors any endpoint can return