DNS Lookup

API key v1

A, AAAA, MX, TXT, NS, CNAME, SOA, CAA and SRV records with DNSSEC status.

Resolves the record types you ask for, or a default set, and reports whether the zone publishes DS records and whether the resolver validated the answer.

GET https://api.zactonz.com/domain/dns/

Parameters

NameTypeDescription
namerequired string

Host or domain name.

type string

Comma-separated record types, or ALL for A, AAAA, MX, TXT, NS, CNAME, SOA and CAA.

Default ALL

Send parameters in the query string.

Response

OK

FieldTypeDescription
status integer

200 on success.

data object

The result.

data.name string

Name queried.

data.records object

One list per type. A and AAAA carry address; MX priority and exchange; TXT text; CNAME, NS and PTR target; SOA the zone fields; CAA flags, tag, value; SRV priority, weight, port, target. Every record has name and ttl.

data.dnssec object

ds_records and validated_by_resolver.

data.queried_at string

Timestamp.

Status codes

The outcome is reported in the JSON status field. See Errors & status codes for the general rules.

400 Bad request

name is missing or a record type is not supported.

401 Unauthorized

The Authorization header is missing or the key is not recognised.

403 Forbidden

The key is not licensed for this product.

429 Too many requests

The per-minute rate or the plan quota is exhausted. Retry after the seconds given in Retry-After.

Notes

Answers are cached for two minutes.