Free DNS Propagation Checker API

Parameters

name	in	type	required	description
`domain`	query	string	required	Domain
`type`	query	string	optional	Record Type one of `AAAAACNAMEMXNSTXT` default `A`
`resolvers`	query	string	optional	Comma-separated, at least two. Leave empty to ask all five.

Request

Send your key in the X-API-Key header. More languages and patterns live on the code examples page.

curl -s "https://apixies.io/api/v1/dns-propagation?domain=example.com" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch("https://apixies.io/api/v1/dns-propagation?domain=example.com", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

$ch = curl_init("https://apixies.io/api/v1/dns-propagation?domain=example.com");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: YOUR_API_KEY"],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);

import requests

res = requests.get(
    "https://apixies.io/api/v1/dns-propagation",
    params={"domain": "example.com"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(res.json())

Response

The result sits under data in the standard envelope. See the response format guide for errors and status codes.

returns

data.consistent: True when every resolver that answered returned the same records.
data.agreement_percent: Share of responding resolvers that agree with the most common answer.
data.answers: Each distinct answer with the resolvers that returned it.
data.results: Per-resolver status, records and TTL.
data.ttl: Lowest and highest TTL seen across resolvers.
data.note: A plain-language read of what a mismatch probably means.

example response 200

{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "Resolvers return different answers",
    "data": {
        "domain": "example.com",
        "type": "A",
        "consistent": false,
        "agreement_percent": 80,
        "resolvers_queried": 5,
        "resolvers_responded": 5,
        "answers": [
            {
                "values": [
                    "93.184.215.14"
                ],
                "resolvers": [
                    "Google",
                    "Cloudflare",
                    "Quad9",
                    "AdGuard"
                ]
            },
            {
                "values": [
                    "93.184.216.34"
                ],
                "resolvers": [
                    "OpenDNS"
                ]
            }
        ],
        "ttl": {
            "min": 120,
            "max": 3600
        },
        "results": [
            {
                "resolver": "Google",
                "ip": "8.8.8.8",
                "status": "ok",
                "values": [
                    "93.184.215.14"
                ],
                "ttl": 120
            },
            {
                "resolver": "OpenDNS",
                "ip": "208.67.222.222",
                "status": "ok",
                "values": [
                    "93.184.216.34"
                ],
                "ttl": 3600
            }
        ],
        "note": "Different answers mean either a recent change is still propagating, or the domain rotates its records (load balancing, geo DNS). Low TTLs usually point to the second.",
        "checked_at": "2026-09-18T12:00:00+00:00"
    }
}

Authentication and limits

This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.

Standard rate limits apply to this endpoint.

related endpoints

GET DNS Lookup Resolve DNS records (A, AAAA, MX, TXT, CNAME, NS, SOA, SRV, CAA, PTR) for any domain GET WHOIS Lookup Look up WHOIS registration data for a domain GET Email Auth Validator Validate SPF, DMARC, and DKIM email authentication records for a domain

getting started

authentication code examples response format

explore

all api endpoints guides and tutorials online tools

resources

homepage changelog suggest an endpoint

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

get a temporary key create an account