Network & DNS
GET
/api/v1/dns-propagationDNS Propagation
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://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" } }