---
title: "Retrieve a list of upcoming system Maintenances"
method: GET
path: "/v2/domains/maintenances"
tags: ["Domains"]
---

# Retrieve a list of upcoming system Maintenances

`GET /v2/domains/maintenances`

## Query parameters

- `status` 'ACTIVE' | 'CANCELLED'
- `modifiedAtAfter` string, iso-datetime
- `startsAtAfter` string, iso-datetime
- `limit` integer

## Headers

- `X-Request-Id` string

## Response `200`

Request was successful

- Maintenance
  - `createdAt` string, iso-datetime, required — Date and time (UTC) when this maintenance was created
  - `endsAt` string, iso-datetime, required — Date and time (UTC) when this maintenance will complete
  - `environment` 'OTE' | 'PRODUCTION', required — The environment on which the maintenance will be performed<br/><ul><li><strong style='margin-left: 12px;'>OTE</strong> - The Operational Testing Environment.</li><li><strong style='margin-left: 12px;'>PRODUCTION</strong> - The Live Production Environment.</li></ul>
  - `maintenanceId` string, required — The identifier for the system maintenance
  - `modifiedAt` string, iso-datetime, required — Date and time (UTC) when this maintenance was last modified
  - `reason` 'EMERGENCY' | 'PLANNED', required — The reason for the maintenance being performed<br/><ul><li><strong style='margin-left: 12px;'>EMERGENCY</strong> - Unexpected Emergency maintenance.</li><li><strong style='margin-left: 12px;'>PLANNED</strong> - Planned system maintenance.</li></ul>
  - `startsAt` string, iso-datetime, required — Date and time (UTC) when this maintenance will start
  - `status` 'ACTIVE' | 'CANCELLED', required — The status of maintenance<br/><ul><li><strong style='margin-left: 12px;'>ACTIVE</strong> - The upcoming maintenance is active.</li><li><strong style='margin-left: 12px;'>CANCELLED</strong> - The upcoming maintenance has been cancelled.</li></ul>
  - `summary` string, required — A brief description of what is being performed
  - `tlds` string[] — List of tlds that are in maintenance. Generally only applies when `type` is REGISTRY
  - `type` 'API' | 'REGISTRY' | 'UI', required — The type of maintenance being performed<br/><ul><li><strong style='margin-left: 12px;'>API</strong> - Programmatic Api components.</li><li><strong style='margin-left: 12px;'>REGISTRY</strong> - The underlying Registry providing the tld(s).</li><li><strong style='margin-left: 12px;'>UI</strong> - User Interface components.</li></ul>

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `422` — Filter parameters don't match schema and/or restrictions
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/domains-api.md) · [All operations](https://skmtc.net/godaddy/apis/domains-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/domains-api/versions/475bd0561c3c/schema)