DNS Zones

List health checks

get/dns/zones/{zone_uuid}/health-checks

View all health checks in a DNS zone and whether each target is currently healthy.

Authorization

Authorization*string

Bearer YOUR_API_TOKEN with an API token. The X-API-Key: YOUR_API_TOKEN header works too.

Path parameters

zone_uuid*string

Responses

Successful Response

application/json

array<DNSHealthCheckOut>

uuid*string

record_uuid*string

name*string

check_type*DNSHealthCheckType

Value in"http""https""tcp""ping"

target?string | null

port?integer | null

path?string | null

expected_status?integer | null

interval_secs*integer

timeout_secs*integer

healthy_threshold*integer

unhealthy_threshold*integer

enabled*boolean

last_status*DNSHealthCheckStatus

Value in"healthy""unhealthy""unknown"

last_check_at?string | null

Formatdate-time

created_at*string

Formatdate-time

updated_at*string

Formatdate-time

status_summary?DNSHealthCheckStatusSummary | null

Current status combined across every location; null while unavailable.

Properties (3)

status*string

healthy: every reporting location sees the target up; unhealthy: every one sees it down; degraded: some locations see it down; unknown: no location is reporting yet; paused: the check is disabled or the zone is not active.

Value in"healthy""degraded""unhealthy""unknown""paused"

pops?array<DNSHealthCheckPopStatus>

Properties (2)

pop*string

Location code, e.g. ams01

status*string

unhealthy when the location sees the target down, unknown while it is not reporting yet.

Value in"healthy""unhealthy""unknown""paused"

last_change_at?string | null

Last status change seen by any location (ISO 8601 UTC)

uptime_24h?number | null

Percentage of the last 24 hours the target was seen up; null without data.