Get check uptime
get_check_uptimeRead one check's uptime over a rolling window: the window's length in seconds (window_seconds), the time spent in incidents (downtime_seconds) and uptime_percentage, which is the incident-free share of the window. The window starts at the check's creation when the check is newer than the period asked for, and uptime_percentage is null until the check has a run or an incident. Time spent paused or pending isn't known and counts as up, so this is incident-free time, not verified availability. days is 7, 14, 30, 90 or 365 and defaults to 30; asking for more than the plan's limits.history_days returns quota_exceeded. An unknown check id returns not_found. time_zone (an IANA name) sets the zone for timestamps; the default is UTC, and the response names its zone.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "get_check_uptime"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Check id (check_…). | |
| days | No | Days of history, up to the plan's limit. Defaults to 30, or the plan's limit when shorter. | |
| time_zone | No | IANA time zone for days and timestamps, such as America/Chicago. Defaults to UTC. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| basis | Yes | ||
| end_at | Yes | ||
| start_at | Yes | ||
| time_zone | Yes | ||
| window_seconds | Yes | ||
| downtime_seconds | Yes | ||
| uptime_percentage | Yes | ||
| paused_and_pending_history_available | Yes |