Skip to main content
GET
List maintenance windows

Authorizations

Authorization
string
header
required

Use a user token to access authenticated routes. The token must be specified in the Authorization HTTP header with the following format 'Authorization: Bearer '.

Headers

X-Phare-Project-Id
integer

A project header is required when using an organization-scoped API key.

Example:

1

X-Phare-Project-Slug
string

A project header is required when using an organization-scoped API key.

Example:

"luminous-guiding-tower"

Query Parameters

monitor_id
integer

Filter maintenance windows by monitor ID. Can be specified multiple times to filter by multiple monitor IDs.

status_page_id
integer

Filter maintenance windows by status page ID. Can be specified multiple times to filter by multiple status page IDs.

state
enum<string>

Filter maintenance windows by state.

Available options:
scheduled,
in_progress,
completed,
cancelled
page
integer
default:1

Page number to show

Example:

1

per_page
integer
default:20

Number of resources to return per page

Required range: 1 <= x <= 100
Example:

20

Response

Success, maintenance windows retrieved

data
object[]
meta
object

Meta data for pagination

Links for pagination

Last modified on August 30, 2026