DNS Zones

Get record health check history

get/dns/zones/{zone_uuid}/records/{record_uuid}/health-check/history

See how a record's health check has behaved over time: uptime, the status seen from each location and the incidents per location with their duration. How far back you can look depends on the zone's DNS plan.

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

record_uuid*string

Query parameters

time_range?string

Period to show. Longer than your plan's history retention returns the longest period available, with clamped set to true.

Default"24h"Value in"24h""7d""30d""90d"

Responses

Successful Response

application/json

check_uuid*string

time_range*string

Value in"24h""7d""30d""90d"

retention_days*integer

clamped*boolean

history_starts_at?string | null

start*string

end*string

bucket_secs*integer

overall*DNSHealthCheckHistoryOverall

Properties (5)

status*string

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

uptime_pct?number | null

coverage_pct?number | null

outage_secs?integer

Default0

last_change_at?string | null

pops*array<DNSHealthCheckHistoryPop>

Properties (6)

pop*string

region?string | null

status*string

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

uptime_pct?number | null

last_error_kind?string | null

last_change_at?string | null

buckets*array<DNSHealthCheckHistoryBucket>

Properties (4)

start*string

uptime_pct?number | null

coverage_pct?number | null

state*string

Value in"ok""degraded""outage""no_data""paused"

pop_buckets*record<string, array<DNSHealthCheckHistoryBucket>>

markers*array<DNSHealthCheckHistoryMarker>

Properties (2)

ts*string

kind*string

Value in"config_changed""disabled""enabled"

incidents*array<DNSHealthCheckHistoryIncident>

Properties (6)

pop*string

started_at*string

resolved_at?string | null

duration_secs?integer | null

error_kind?string | null

http_status?integer | null

Status code received, only for http_status_mismatch.