🔍

DNS Propagation Checker

Check DNS propagation across 20+ global resolvers.

GET /v1/propagation

curl "https://dns.toolkitapi.io/v1/propagation?domain=toolkitapi.io&type=A"

import httpx

resp = httpx.get(
    "https://dns.toolkitapi.io/v1/propagation?domain=toolkitapi.io&type=A",
)
print(resp.json())

const resp = await fetch("https://dns.toolkitapi.io/v1/propagation?domain=toolkitapi.io&type=A", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "status": "ok",
  "data": {
    "domain": "toolkitapi.io",
    "record_type": "A",
    "consistent": true,
    "consistency_pct": 100.0,
    "resolvers_queried": 20,
    "results": [
      {"resolver": "8.8.8.8", "name": "Google", "records": ["93.184.216.34"], "response_time_ms": 12},
      {"resolver": "1.1.1.1", "name": "Cloudflare", "records": ["93.184.216.34"], "response_time_ms": 8}
    ]
  }
}

Try It Live

Description

Check DNS propagation across 20+ global resolvers.

How to Use

1

1. Provide the domain you want to check in the `domain` query parameter.

2

2. Optionally set the `type` parameter to the record type you changed (A, AAAA, CNAME, MX, NS, TXT, SOA, CAA, PTR). Defaults to `A`.

3

3. Send a GET request and inspect the `consistency_pct` field. If it's below 100 %, some resolvers still have cached stale data.

4

4. Repeat after a few minutes until all resolvers agree.

About This Tool

DNS Propagation Checker queries your domain against 20+ globally-distributed public DNS resolvers simultaneously and compares the results. It reports which resolvers have picked up the latest records, average resolution time, and an overall consistency score.

Use this tool right after making DNS changes — zone file edits, nameserver migrations, or CDN switches — to verify that your updates have reached resolvers worldwide.

The consistency percentage tells you at a glance how far along propagation is: 100 % means every resolver agrees on the same answer.

Why Use This Tool

Post-migration verification — Confirm nameserver or hosting provider changes have propagated
TTL validation — Verify that reduced TTLs are taking effect before a planned cutover
CDN rollout monitoring — Track CNAME/A record propagation when onboarding a CDN
Troubleshooting regional failures — Identify resolvers that disagree to pinpoint stale caches

Frequently Asked Questions

How many resolvers are queried?

The propagation checker queries 20+ public DNS resolvers distributed across North America, Europe, Asia, and Oceania. The exact list includes Google (8.8.8.8), Cloudflare (1.1.1.1), Quad9 (9.9.9.9), OpenDNS, and regional providers.

Why do some resolvers show old records?

DNS records are cached according to their TTL (Time To Live). After you update a record, each resolver will continue serving the old value until its cached copy expires. High-TTL records can take up to 48 hours to propagate fully.

Can I check propagation for any record type?

Yes — the tool supports A, AAAA, CNAME, MX, NS, TXT, SOA, CAA, and PTR record types.

Start using DNS Propagation Checker now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs