---
title: DNS Batch Lookup API
slug: mono-go-dns-batch-lookup
url: https://apyhub.com/apyhub/service/mono-go-dns-batch-lookup
provider: ApyHub
categories: [Developer Tools]
tags: [dns-lookup, dns, batch-lookup, domain-resolution, ptr-lookup, mx-records]
auth: api_key
---

# DNS Batch Lookup API

Batch resolve domains or IPs for A, AAAA, MX, NS, TXT, CNAME, and PTR records. Get per-row status plus record data for each query.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `` | What it does Performs up to 25 DNS lookups in a single request. You send a list of queries, and the… | 100 |

## About

## 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.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/mono-go-dns-batch-lookup