GET/v1/maintenance-windows

Get all maintenance windows

Returns a list of all maintenance windows for a project.

Request

This endpoint does not require any parameters.

Response

Returns an array of maintenance window objects.

Maintenance Window Objectapplication/json

uuidstring

Unique identifier for the maintenance window

namestring

Internal name for the maintenance window

titleobject

Localized title shown on status pages

start_datestring

Start date in ISO 8601 format

end_datestring

End date in ISO 8601 format

monitorsarray<string>

Array of monitor and component UUIDs

statuspagesarray<string>

Array of status page UUIDs

statusenum<string>

Current status of the maintenance window

Possible values:

upcomingongoingcompleted

RequestcURL

curl https://api.hyperping.io/v1/maintenance-windows \
  -H "Authorization: Bearer ${API_TOKEN}"

200 OKJSON

[
  {
    "uuid": "mw_TY2vFNUbdzdskD",
    "name": "Scheduled API Infrastructure Upgrade",
    "title": {
      "en": "Planned API Gateway Maintenance"
    },
    "start_date": "2025-12-17T14:30:00.000Z",
    "end_date": "2025-12-17T18:30:00.000Z",
    "timezone": "UTC",
    "monitors": [
      "mon_XeYIdBFK0prmGn"
    ],
    "statuspages": [
      "sp_jsQqcFiwoK7ZjM"
    ],
    "status": "upcoming"
  }
]

← Maintenance API Get a maintenance window →