Network & DNS

GET/api/v1/dns-propagation

PacketFlo DNS Propagation API

Cost: 3 credits per request

See which public resolvers have picked up a DNS change.

ParameterTypeRequiredDescription
domainstringYesDomain to check.
typestringNoRecord 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

FieldWhat it tells you
domain / typeThe queried name and record type; defaults to A.
resolversPer-resolver records, error, response time in milliseconds and matches comparison against the majority answer.
unreachableResolvers 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 statusMeaning
200The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition.
400Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details.
401Missing, invalid or revoked API key.
429The request would exceed the key's available credit budget.
MX Lookup