v2

latestOpenAPI 3.0.02026-07-261859071.2 MB
Analytics

Get analytics summary for multiple checks

Returns availability, response times, and latency metrics for the given checks. Response shape is polymorphic per check type: fields are present only when the metric applies to that type. A null value means no data in the requested time range; an absent field means the metric does not apply to that check type. Currently only quickRange is supported for time filtering. Arbitrary from/to date ranges are not yet supported but may be added in a future release. Rate-limiting is applied to this endpoint, you can send 30 requests / 60 seconds at most.

post/v1/analytics/checks

Query parameters

quickRange'last24Hours' | 'last7Days' | 'thisWeek' | 'lastWeek' | 'lastMonth'

Time range for analytics.

Time range for analytics.

Headers

x-checkly-accountstring

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Request body

checkIdsstring[] required

Array of check IDs to fetch analytics for.

Response

Successful

checkIdstring required
checkType'AGENTIC' | 'API' | 'BROWSER' | 'HEARTBEAT' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'TRACEROUTE' | 'URL' | 'DNS' | 'SSL' | 'GRPC' required
availabilitynumber nullable
responseTime_avgnumber nullable
responseTime_p50number nullable
responseTime_p95number nullable
responseTime_p99number nullable
latency_avgnumber nullable
latency_p50number nullable
latency_p95number nullable
latency_p99number nullable
packetLoss_avgnumber nullable
packetLoss_p95number nullable
packetLoss_p99number nullable
hopCount_avgnumber nullable