Check DNS propagation for a domain

Check if DNS changes have propagated globally for your domain. This is useful when you have made updates to your DNS settings, such as changing nameservers or DNS records, and want to verify that the changes have taken effect everywhere. The API returns a status indicating if propagation is complete and provides details about the nameservers.

Query Parameters

domain string required
nameserver string

Headers

Accept Example
Content-Type Example

Responses

200
success boolean
timestamp string
requestId string
data object
GET https://cloud.hostup.se/api/dns-propagation
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/dns-propagation?domain=string" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "success": true,
    "domain": "string",
    "propagated": true,
    "allPropagated": true,
    "resolves": true,
    "actualNameservers": [
      "string"
    ],
    "providedNameservers": [
      "string"
    ],
    "matchingNameservers": [
      "string"
    ],
    "propagationStatus": "string",
    "checkSource": "string",
    "checks": {
      "registryDelegation": {
        "success": true,
        "tld": "string",
        "error": "string",
        "attempts": [
          {
            "hostname": "string",
            "ip": "string",
            "error": "string"
          }
        ]
      },
      "recursiveResolver": {
        "actualNameservers": [
          "string"
        ]
      }
    },
    "message": "string",
    "timestamp": "string"
  }
}