Check DNS propagation for your domains

Check if your DNS changes have propagated globally. This is useful when you have updated DNS settings for your domains and want to verify they are active everywhere. The API returns a unique ID that you can use to track results in other systems.

Headers

Accept Example
Content-Type Example

Body

required
application/json
domains array required

Responses

200
success boolean
timestamp string
requestId string
data object
POST https://cloud.hostup.se/api/dns-propagation
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/dns-propagation" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": [
      "string"
    ]
  }'
Response 
{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "results": [
      {
        "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"
      }
    ]
  }
}
Request Body 
{
  "domains": [
    "string"
  ]
}