---
title: "GET /api/maintenance_windows"
method: GET
path: "/api/maintenance_windows"
tags: ["maintenance_windows"]
---

# GET /api/maintenance_windows

`GET /api/maintenance_windows`

## Request

- Base URL: `https://cronitor.io`
- URL: `https://cronitor.io/api/maintenance_windows`
- Auth: HTTP basic

## Query parameters

- `page` integer
- `pageSize` integer

## Headers

- `Cronitor-Version` '2025-11-28' | '2020-10-01'

## Response `200`

- PaginatedMaintenanceWindowList
  - `page` integer, required
  - `page_count` integer, required
  - `page_size` integer, required
  - `total_count` integer, required
  - `data` MaintenanceWindow[], required
    - `key` string, required
    - `name` string, required
    - `description` string, nullable
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `affects_all_monitors` boolean
    - `affects_statuspage_components` boolean
    - `environment` string, nullable: Environment key.
    - `statuspages` string[]: Status page keys.
    - `monitors` unknown[]
      - unknown
    - `groups` unknown[]
      - unknown
    - `all_affected_monitors` string, required
    - `duration` integer, required: Returns the total duration of the maintenance window in seconds.
    - `state` string, required: Returns whether the window is currently past|ongoing|upcoming.
    - `created` string, date-time, required
    - `updated` string, date-time, required

---

[API](https://skmtc.dev/cronitor/apis/cronitor-api.md) - [All operations](https://skmtc.dev/cronitor/apis/cronitor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cronitor/apis/cronitor-api/revisions/62fb38ef4462?raw)