API referenceMonitors
Get a monitor's status history
Returns the monitor's status-timeline segments over a look-back window (default 30 days, max 90), newest first — for "when was it last down" questions.
Authorization
bearerAuth AuthorizationBearer <token>
An uptimely_live_ project API key (Settings → API Keys).
In: header
Path Parameters
monitor_id*string
Monitor id.
Match
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidQuery Parameters
days?integer
Look-back window in days (1-90).
Range
1 <= value <= 90Default
30limit?integer
Maximum number of segments to return (1-200).
Range
1 <= value <= 200Default
50Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/monitors/497f6eca-6276-4993-bfeb-53cbbbba6f08/status-history"{ "monitor": { "id": "string", "name": "string", "monitor_type": "string" }, "window_days": -9007199254740991, "data": [ { "status": { "name": "string", "color": "string" }, "starts_at": "2019-08-24T14:15:22Z", "ends_at": "2019-08-24T14:15:22Z", "root_cause": "string" } ]}