Skip to main content
GET
/
api
/
v1
/
status-pages
/
{id}
/
maintenance
Get maintenance windows for a status page
curl --request GET \
  --url https://api.example.com/api/v1/status-pages/{id}/maintenance
{
  "items": [
    {
      "id": "<string>",
      "statusPageId": "<string>",
      "organizationId": "<string>",
      "title": "<string>",
      "status": "scheduled",
      "scheduledStartAt": "2023-11-07T05:31:56Z",
      "scheduledEndAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "updates": [
        {
          "id": "<string>",
          "maintenanceId": "<string>",
          "content": "<string>",
          "status": "scheduled",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        }
      ],
      "description": "<string>",
      "actualStartAt": "2023-11-07T05:31:56Z",
      "actualEndAt": "2023-11-07T05:31:56Z"
    }
  ],
  "page": 123,
  "limit": 123,
  "total": 123,
  "hasMore": true
}

Documentation Index

Fetch the complete documentation index at: https://getmonitor.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
id
string
required

Query Parameters

​
limit
integer
default:20
​
page
integer
default:1
​
startDate
string

ISO 8601 datetime — enables date-range mode (requires endDate)

Example:

"2024-01-01T00:00:00Z"

​
endDate
string

ISO 8601 datetime — enables date-range mode (requires startDate)

Example:

"2024-01-31T23:59:59Z"

​
status
enum<string>

Filter by status

Available options:
scheduled,
in_progress,
completed,
cancelled

Response

200 - application/json

Maintenance windows. Returns a paginated object in normal mode; a bare array when both startDate and endDate are provided.

​
items
object[]
required
​
page
integer
required
​
limit
integer
required
​
total
integer
required
​
hasMore
boolean
required