---
title: "List all maintenance windows"
method: GET
path: "/v1/maintenance-windows"
tags: ["Maintenance windows"]
---

# List all maintenance windows

`GET /v1/maintenance-windows`

Lists all maintenance windows in your account.

## Query parameters

- `limit` integer — Limit the number of results
- `page` number — Page number
- `startsAt` union — Filter for items which startsAt field matches the constraint
  - object
    - `gt` string, date, required
  - object
    - `gte` string, date, required
  - object
    - `lt` string, date, required
  - object
    - `lte` string, date, required
- `endsAt` union — Filter for items which endsAt field matches the constraint
  - object
    - `gt` string, date, required
  - object
    - `gte` string, date, required
  - object
    - `lt` string, date, required
  - object
    - `lte` string, date, required

## Headers

- `x-checkly-account` string — Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- MaintenanceWindow[]
  - `id` number, required — The id of the maintenance window.
  - `name` string, required
  - `tags` string[] — The names of the checks and groups maintenance window should apply to.
  - `startsAt` string, date, required
  - `endsAt` string, date, required
  - `repeatInterval` number, nullable
  - `repeatUnit` 'DAY' | 'WEEK' | 'MONTH', nullable
  - `repeatEndsAt` string, date, nullable
  - `timezone` string, nullable
  - `description` string, nullable
  - `statusPageVisibility` MaintenanceWindowStatusPageVisibilityResponse
    - `enabled` boolean
    - `severity` 'MINOR' | 'MEDIUM' | 'MAJOR' | 'CRITICAL', nullable
    - `affectAllServices` boolean
    - `suppressAutoIncidents` boolean
    - `notifyOnStart` boolean
    - `notifyOnEnd` boolean
    - `reminderMinutesBefore` integer[]
    - `autoStart` boolean
    - `autoEnd` boolean
    - `showAffectedServices` boolean
    - `statusPageIds` string[]
    - `serviceIds` string[]
  - `pauseAllChecks` boolean
  - `silenceAlertsTags` string[]
  - `silenceAllAlerts` boolean
  - `created_at` string, date, required — The creation date of the maintenance window.
  - `updated_at` string, date, nullable, required — The last date that the maintenance window was updated.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/checklyhq/apis/checkly-public-api.md) · [All operations](https://skmtc.net/checklyhq/apis/checkly-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checklyhq/checkly-public-api/revisions/9e903da4f3da/schema)