POST AI agent ready /v1/dns/propagation

DNS Propagation Check API - Free Global Resolver Test

Queries multiple public DNS resolvers (Google, Cloudflare, Quad9) for a domain and reports whether results are consistent.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/dns/propagation \
  -H "Content-Type: application/json" \
  -d '{"domain":"botoi.com","type":"A"}'

When to use this API

Confirm DNS changes after a migration

After migrating a website to a new hosting provider, check whether the updated A records have propagated across Google, Cloudflare, and Quad9. Wait until the consistent flag is true before switching traffic or updating monitoring tools.

Debug region-specific DNS failures

When users in certain regions report they cannot reach your site, check propagation to see if specific resolvers return stale or incorrect records. This narrows the problem to a caching issue at a particular resolver versus a misconfiguration at your registrar.

Automate DNS change verification in CI/CD

After a Terraform or Pulumi deployment updates DNS records, add a pipeline step that polls this endpoint. Fail the pipeline if records are not consistent across all resolvers within 5 minutes.

Frequently asked questions

Which DNS resolvers are checked?

Google (8.8.8.8), Cloudflare (1.1.1.1), and Quad9 (9.9.9.9). These represent three of the most widely used public DNS resolvers.

What does the consistent field mean?

consistent is true when all three resolvers return the same set of records. If any resolver returns different values, consistent is false.

How long does DNS propagation take?

It depends on the TTL of the old record. Most changes propagate within 5 minutes to 48 hours. Short TTLs (300 seconds) propagate faster than long ones (86400 seconds).

Can I check propagation for MX or TXT records?

Yes. Set the type parameter to MX, TXT, CNAME, AAAA, or any supported record type. It defaults to A if omitted.

Get your API key

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