🚀 Experience the new and improved APIVoid! Check out what's new
A JSON API to check if DNS records of a domain have propagated globally, across the world (US, EU, AS). Use this API to perform globally-distributed DNS lookups and test if DNS records have propagated worldwide.
Consumes 5 credits per API call
# Example Curl request from the command line:
curl -X POST "https://api.apivoid.com/v2/dns-propagation" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY_HERE" \
-d '{
"host":"example.com",
"dns_types":"A,AAAA,MX,NS,TXT,SOA,SRV,CAA"
}'
# Example JSON output for a 200 HTTP status code:
{
"host": "example.com",
"propagation": [
{
"continent_code": "NA",
"continent_name": "North America",
"country_code": "US",
"country_name": "United States",
"city_name": "New York City",
"response": [
{
"dns_type": "A",
"records": [
"96.7.128.198",
"23.215.0.136",
"23.192.228.80",
"23.192.228.84",
"23.215.0.138",
"96.7.128.175"
]
},
{
"dns_type": "AAAA",
"records": [
"2600:1406:3a00:21::173e:2e66",
"2600:1406:bc00:53::b81e:94c8",
"2600:1406:3a00:21::173e:2e65",
"2600:1406:bc00:53::b81e:94ce",
"2600:1408:ec00:36::1736:7f24",
"2600:1408:ec00:36::1736:7f31"
]
},
{
"dns_type": "MX",
"records": [
"gmail-smtp-in.l.google.com",
"alt1.gmail-smtp-in.l.google.com",
"alt4.gmail-smtp-in.l.google.com",
"alt2.gmail-smtp-in.l.google.com",
"alt3.gmail-smtp-in.l.google.com"
]
},
{
"dns_type": "NS",
"records": [
"a.iana-servers.net",
"b.iana-servers.net"
]
},
{
"dns_type": "TXT",
"records": [
"v=spf1 -all",
"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"
]
},
{
"dns_type": "SRV",
"records": [
{
"port": "5060",
"priority": "10",
"target": "ygg1.vp.vc",
"weight": "100"
},
{
"port": "5060",
"priority": "50",
"target": "ygg2.vp.vc",
"weight": "100"
}
]
},
{
"dns_type": "SOA",
"records": [
{
"expire": "1209600",
"minttl": "3600",
"mname": "ns.icann.org",
"refresh": "7200",
"retry": "3600",
"rname": "noc@dns.icann.org",
"serial": "2025011515"
}
]
},
{
"dns_type": "CAA",
"records": [
{
"flag": "0",
"tag": "issue",
"value": "visa.com"
},
{
"flag": "0",
"tag": "issue",
"value": "digicert.com"
},
{
"flag": "0",
"tag": "issue",
"value": "quovadisglobal.com"
}
]
}
]
},
{
"continent_code": "NA",
"continent_name": "North America",
"country_code": "US",
"country_name": "United States",
"city_name": "San Francisco",
"response": [
{
"dns_type": "A",
"records": [
"23.192.228.80",
"23.192.228.84",
"23.215.0.136",
"23.215.0.138",
"96.7.128.175",
"96.7.128.198"
]
},
{
"dns_type": "AAAA",
"records": [
"2600:1406:3a00:21::173e:2e66",
"2600:1406:bc00:53::b81e:94c8",
"2600:1406:bc00:53::b81e:94ce",
"2600:1408:ec00:36::1736:7f24",
"2600:1408:ec00:36::1736:7f31",
"2600:1406:3a00:21::173e:2e65"
]
},
{
"dns_type": "MX",
"records": [
"gmail-smtp-in.l.google.com",
"alt1.gmail-smtp-in.l.google.com",
"alt4.gmail-smtp-in.l.google.com",
"alt2.gmail-smtp-in.l.google.com",
"alt3.gmail-smtp-in.l.google.com"
]
},
{
"dns_type": "NS",
"records": [
"b.iana-servers.net",
"a.iana-servers.net"
]
},
{
"dns_type": "TXT",
"records": [
"v=spf1 -all",
"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"
]
},
{
"dns_type": "SRV",
"records": [
{
"port": "5060",
"priority": "10",
"target": "ygg1.vp.vc",
"weight": "100"
},
{
"port": "5060",
"priority": "50",
"target": "ygg2.vp.vc",
"weight": "100"
}
]
},
{
"dns_type": "SOA",
"records": [
{
"expire": "1209600",
"minttl": "3600",
"mname": "ns.icann.org",
"refresh": "7200",
"retry": "3600",
"rname": "noc@dns.icann.org",
"serial": "2025011515"
}
]
},
{
"dns_type": "CAA",
"records": [
{
"flag": "0",
"tag": "issue",
"value": "visa.com"
},
{
"flag": "0",
"tag": "issue",
"value": "digicert.com"
},
{
"flag": "0",
"tag": "issue",
"value": "quovadisglobal.com"
}
]
}
]
},
...
],
"elapsed_ms": 155
}
Key Features
Businesses and startups use this DNS Propagation API to verify that specific DNS records (e.g A, AAAA, TXT, MX) have correctly propagated globally across Europe, America and Asia.
You can specify a single DNS record or multiple DNS records (comma separated) in a single API call.
Starting from the Startup plan you can also specify multiple domain names in a single API call.
The API accurately checks if specified DNS records have propagated in Europe, America and Asia.
The submitted domain is analyzed in real-time and the response is returned in 1-3 seconds on average.
Common Use Cases
Our API can be used in many ways, from cybersecurity tasks to marketing-specific tasks. Here we showcase the most popular use cases according to our customers usage:
This API can be used to validate that all DNS records have fully propagated around the world.
Commonly used to verify that TXT DNS records of a domain have correctly propagated globally.
If you are monitoring DNS records of customers, include also this DNS propagation test.
Use this API to provide your customer an option to check if their DNS records have propagated.
USAGE EXAMPLE
All it takes is a HTTPS POST request with JSON payload to our endpoint, and you’ll receive the response within seconds, usually within 1-3 seconds. Here are a few code examples to use the API:
$domain = 'google.com';
$dnsType = 'A';
$apiUrl = 'https://api.apivoid.com/v2/dns-propagation';
$apiKey = 'your_api_key_here';
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json', 'X-API-Key: ' . $apiKey]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['domain' => $domain, 'dns_type' => $dnsType]));
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$responseData = json_decode($response, true);
print_r($responseData);
}Create your account, pick a subscription plan, and make your first API call instantly with your API key—simple as that!
Get started now