Skip to main content
GET
List maintenances

Authorizations

Authorization
string
header
required

An organization API key (obs_pub_…) sent as Authorization: Bearer <key>. Each key carries scopes; an endpoint lists the scope it needs. read:change_events is reserved: keys can carry it, but no endpoint needs it yet.

Scopes

read:maintenances

Query Parameters

limit
integer
default:50

Page size. Out-of-range values are clamped.

Required range: 1 <= x <= 200
cursor
string

Opaque cursor from the previous page's next_cursor.

state
enum<string>
default:all

open: not finished (neither completed nor canceled). resolved: finished, i.e. completed (actual_end_at set) or canceled (canceled_at set). all: both. Any other value is a 400 invalid_state.

Available options:
open,
resolved,
all
since
string

Only windows dated at or after this ISO 8601 date or date-time (no offset = UTC).

Examples:

"2026-01-31"

"2026-01-31T12:00:00Z"

Response

ok

items
object[]
required
next_cursor
string | null