Skip to Content
SeyloDocs
API referenceUptime checks

Get uptime history

GET
/api/v1/uptime.history

Returns a check's samples for a range as a series for the chart (raw samples for 1h and 24h, hourly buckets for 7d and 30d), plus uptime percent, average latency and the down periods.

Needs services.view on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
checkId*string

Panel-issued id.

Match^[a-z0-9]{16}$
range*string|string|string|string

Response Body

Success.

application/json
  1. response
range*string|string|string|string
bucketSeconds*integer
Range0 <= value
points*array<>
uptimePercent*|null
avgLatencyMs*|null
incidents*array<>
Example Request
curl -X GET 'https://example.com/api/v1/uptime.history?serviceId=string&checkId=string&range=1h'
Example Response
{  "range": "1h",  "bucketSeconds": 0,  "points": [    {      "at": "2019-08-24T14:15:22Z",      "ok": 0,      "latencyMs": 0,      "statusCode": 0    }  ],  "uptimePercent": 0,  "avgLatencyMs": 0,  "incidents": [    {      "from": "2019-08-24T14:15:22Z",      "to": "2019-08-24T14:15:22Z",      "error": "string"    }  ]}