Network & DNS
/api/v1/dns-propagationPacketFlo DNS Propagation API
See which public resolvers have picked up a DNS change.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain to check. |
type | string | No | Record type — A, AAAA, MX, TXT, CNAME, NS, or SOA. Defaults to "A". |
Example request
curl "https://packetflo.io/api/v1/dns-propagation?domain=example.com&type=A&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "domain": "example.com", "type": "A", "status": "propagated", "unreachable": [], "resolvers": [ { "name": "Google", "ip": "8.8.8.8", "domain": "google.com", "countryCode": "US", "records": ["104.16.132.229"], "error": null, "responseTime": 43, "matches": true }, { "name": "Cloudflare", "ip": "1.1.1.1", "domain": "cloudflare.com", "countryCode": "US", "records": ["104.16.132.229"], "error": null, "responseTime": 7, "matches": true }, { "name": "Level3", "ip": "4.2.2.1", "domain": "level3.com", "countryCode": "US", "records": [], "error": "Timed out", "responseTime": 4988, "matches": false } // ... 5 more resolvers ] }, "meta": { "tool": "dns-propagation", "version": "v1" } }
Reading the result
propagated means successful resolvers agree on nonempty records; empty means they agree on no records. propagating indicates disagreement, and failed means no resolver succeeded.
Response fields
| Field | What it tells you |
|---|---|
domain / type | The queried name and record type; defaults to A. |
resolvers | Per-resolver records, error, response time in milliseconds and matches comparison against the majority answer. |
unreachable | Resolvers that failed. They are excluded from agreement, so a propagated result can still have unreachable resolvers. |
Scope and limits
Queries configured public resolvers in parallel with a four-second timeout per resolver. Provider and country labels do not represent probes deployed in every region. Agreement is a sample, not proof of worldwide propagation.
Authentication and errors
Send your key in the x-api-key header, or the supported api_key query parameter. Each request uses 3 credits from the key's shared 300-credit rolling 24-hour budget. Credits are charged before parameter validation. Successful responses and quota errors include usage headers; GET and OPTIONS support CORS.
| API status | Meaning |
|---|---|
200 | The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition. |
400 | Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details. |
401 | Missing, invalid or revoked API key. |
429 | The request would exceed the key's available credit budget. |