Downtimes

Get Downtimes

get

Returns a list of downtimes in your organization.

Authorizations

Bearer

AuthorizationstringRequired

Query parameters

cursorstringOptional

machinestring · uuid[] · max: 50 · nullableOptional

If not set, downtimes for all machines will be considered.

startstring · date-time · nullableOptional

Only downtimes that were observed starting at start will be returned. If not set, no lower time bound will be assumed.

Example: 2023-07-19T19:39:46.735269+02:00

endstring · date-time · nullableOptional

Only downtimes that were observed up to end will be returned. If not set, no upper time bound will be assumed.

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get/v2/downtimes

HTTPcURLJavaScriptPython

GET /api/v2/downtimes HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "machine": "123e4567-e89b-12d3-a456-426614174000",
      "comment": "text",
      "type": "THRESHOLD",
      "updated": {
        "first_name": "text",
        "last_name": "text",
        "timestamp": "2026-07-18T19:00:37.247Z"
      },
      "reason": {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "description": "text",
        "category": "PLANNED",
        "group": "text",
        "state": "active",
        "catalog": "123e4567-e89b-12d3-a456-426614174000"
      },
      "start": "2026-07-18T19:00:37.247Z",
      "end": "2026-07-18T19:00:37.247Z"
    }
  ],
  "metadata": {
    "next_cursor": "text"
  }
}