Fast, stateless Network Diagnostics

Network & DNS

GET/api/v1/dns-propagation

DNS Propagation

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://netsh.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", "countryCode": "US", "records": ["104.16.132.229"], "error": null, "responseTime": 43, "matches": true },
      { "name": "Cloudflare", "ip": "1.1.1.1", "countryCode": "US", "records": ["104.16.132.229"], "error": null, "responseTime": 7, "matches": true },
      { "name": "Level3", "ip": "4.2.2.1", "countryCode": "US", "records": [], "error": "Timed out", "responseTime": 4988, "matches": false }
      // ... 5 more resolvers
    ]
  },
  "meta": { "tool": "dns-propagation", "version": "v1" }
}