DAdatadog
Case Management

List maintenance windows

Returns all configured maintenance windows for event management cases. Maintenance windows define time periods during which case notifications and automation rules are suppressed for cases matching a given query.

get/api/v2/maintenance_windows

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/maintenance_windows
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: event_correlation_config_read

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "end_at": "2026-06-01T06:00:00Z",
        "name": "Weekly maintenance",
        "query": "project:SEC",
        "start_at": "2026-06-01T00:00:00Z"
      },
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "maintenance_window"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.