---
title: "Retrieve a maintenance window"
method: GET
path: "/v1/maintenance-windows/{id}"
tags: ["Maintenance windows"]
---

# Retrieve a maintenance window

`GET /v1/maintenance-windows/{id}`

Show details of a specific maintenance window.

## Path parameters

- `id` integer, 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
- `404` — Not Found
- `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/versions/9e903da4f3da/schema)