Skip to content
POST AI agent ready /v1/dns/batch

DNS Batch Lookup API - Free Multi-Record Query

Queries multiple DNS record types for a domain in parallel. Defaults to A, AAAA, MX, TXT, and NS if no types specified.

Parameters

stringrequired

Domain name to look up.

array

Record types to query. Defaults to A, AAAA, MX, TXT, NS if omitted.

Code examples

curl -X POST https://api.botoi.com/v1/dns/batch \
  -H "Content-Type: application/json" \
  -d '{"domain":"github.com","types":["A","MX","TXT"]}'

When to use this API

Run a full DNS audit for a domain

Pull all record types at once to audit a domain's DNS configuration. Compare the results against your expected values to catch misconfigurations in A, MX, TXT (SPF/DKIM), and NS records in a single API call.

Pre-populate a domain setup wizard

When a user enters their domain during onboarding, fetch all relevant DNS records in one request. Pre-fill the wizard with existing values so the user can see what needs to change to complete the integration.

Frequently asked questions

What is the default set of record types?
If you omit the types parameter, the endpoint queries A, AAAA, MX, TXT, and NS records. These cover the most common DNS configuration needs.
Are the record types queried in parallel?
Yes. All requested record types are resolved concurrently, so a batch query is faster than sending individual requests for each type.
What happens if one record type returns no results?
Record types with no results return an empty array in the results object. The request does not fail because of missing records.
Can I query more than 5 record types?
Yes. You can include any combination of supported types: A, AAAA, MX, TXT, CNAME, NS, SOA, and PTR.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.