Skip to content

DNS check reference

The full schema is in the auto-generated API Reference. Cheat sheet below.

FieldTypeDescription
iduuidDNS check ID.
account_iduuidOwning account.
http_job_iduuidThe HTTP check this was paired with.
current_statusenumSee status table.
domainstringRegistrable domain extracted from the HTTP check’s URL.
expiry_daterfc3339 | nullDomain registration expiry (when available via WHOIS).
last_run_atrfc3339 | nullMost recent resolution timestamp.
last_status_change_atrfc3339 | nullWhen current_status last transitioned.
created_atrfc3339When the check was provisioned.
StatusMeaning
healthyResolution succeeded across the resolver pool.
pending_failureOne resolution failed; next confirms.
failedTwo consecutive resolution failures. Triggers notifications.
MethodPathPurpose
GET/dns/job/{dns_job_id}Fetch current status.
GET/dns/job/{dns_job_id}/recentRecent resolution results.

Toggle on/off via PUT /http/job/{job_id} with monitor_dns: true|false.