Verify Domain API

Check a record

Make requests from your backend. Create a labeled key in your account and store it as VERIFY_DOMAIN_API_KEY.

curl -X POST 'https://api.verifydomainapi.com/v1/dns/check' \
  -H "Authorization: Bearer $VERIFY_DOMAIN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"www.example.com","type":"CNAME","expected":["sites.builder.example"]}'

Example request. Replace the name and target with the values for your domain.

OpenAPI specification · Runnable website builder example

Expected values

A and AAAA
Supply the complete address set for one address family. An empty array means that family must be absent.
CNAME
Supply one direct target. DNS proxies and flattened aliases can hide it from public resolvers.
TXT
Supply one exact token. Generate it on your backend and bind it to the account, site, and hostname. Other TXT records can coexist.
MX
Supply the full set of {"priority":10,"exchange":"mail.example.com"} pairs. Use an empty array for absence or [{"priority":0,"exchange":"."}] for explicit null MX.

Reading a result

matched and mismatch require two conclusive resolver observations. For a routing or mail mismatch, inspect missing and unexpected. observedAt is Unix time in milliseconds. unavailable means the check needs another observation.

Throttling and retries

Free admits up to 10 requests per rolling minute and Pro up to 25, shared across keys. A 429 rate_limited response carries Retry-After in seconds. For quota_exhausted, use resetAt. A 503 means the service is temporarily unavailable. Retry only the affected check with bounded backoff. Only conclusive results use monthly allowance.

Verify Domain API is provided on a best-effort basis. Plan limits are maximums. We do not guarantee uptime, throughput, or that you will be able to use your full allowance during a billing period.