---
title: "Retrieve the details for an upcoming system Maintenances"
method: GET
path: "/v2/domains/maintenances/{maintenanceId}"
tags: ["Domains"]
---

# Retrieve the details for an upcoming system Maintenances

`GET /v2/domains/maintenances/{maintenanceId}`

## Path parameters

- `maintenanceId` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Request was successful

- MaintenanceDetail
  - `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
  - `systems` MaintenanceSystem[] — List of systems that are impacted by the maintenance.
    - `name` 'DOMAIN_CHECKS' | 'DOMAIN_MANAGEMENT' | 'DOMAIN_REGISTRATION' | 'DOMAIN_REGISTRATION_DATA' | 'DOMAIN_RESOLUTION' | 'RESELLER_ADMIN_PORTAL' | 'RESELLER_STOREFRONT', required — The name of the system affected by the maintenance<br/><ul><li><strong style='margin-left: 12px;'>DOMAIN_CHECKS</strong> - Refers to domain availability checks.</li><li><strong style='margin-left: 12px;'>DOMAIN_MANAGEMENT</strong> - Refers to domain management options including various update options on the domain, contacts, records, etc.</li><li><strong style='margin-left: 12px;'>DOMAIN_REGISTRATION</strong> - Refers to domain registrations, renewals, transfers.</li><li><strong style='margin-left: 12px;'>DOMAIN_REGISTRATION_DATA</strong> - Refers to RDAP and WHOIS Service queries for domains.</li><li><strong style='margin-left: 12px;'>DOMAIN_RESOLUTION</strong> - Refers to DNS resolution for domains.</li><li><strong style='margin-left: 12px;'>RESELLER_ADMIN_PORTAL</strong> - Refers to Admin portals to manage the reseller account and settings.</li><li><strong style='margin-left: 12px;'>RESELLER_STOREFRONT</strong> - Refers to the Reseller Storefront features (Standard and Custom).</li></ul>
    - `impact` string[], required — The impact of the maintenance to the system<br/><ul><li><strong style='margin-left: 12px;'>DELAYED</strong> - This response generally applies to systems where the request is queued up and processed once the system is back online.</li><li><strong style='margin-left: 12px;'>DOWN</strong> - The system will be entirely offline; errors are expected.</li><li><strong style='margin-left: 12px;'>NON_AUTHORITATIVE</strong> - This response generally applies to DOMAIN_CHECKS and DOMAIN_MANAGEMENT `system` values where a cached answer will be supplied.</li><li><strong style='margin-left: 12px;'>PARTIAL</strong> - The system will experience partial feature outages; some errors are expected.</li></ul>
  - `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
- `404` — The maintenance does not exist
- `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/revisions/475bd0561c3c/schema)