DAdatadog
Downtimes

Get active downtimes for a monitor

Get all active downtimes for the specified monitor.

get/api/v2/monitor/{monitor_id}/downtime_matches

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/monitor/{monitor_id}/downtime_matches
  • 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: monitors_downtime

Path parameters

monitor_idinteger required

The id of the monitor.

Query parameters

page[offset]integer

Specific offset to use as the beginning of the returned page.

page[limit]integer

Maximum number of downtimes in the response.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "end": "2020-01-02 03:04:00+00:00",
        "groups": [
          "service:postgres",
          "team:frontend"
        ],
        "scope": "env:(staging OR prod) AND datacenter:us-east-1",
        "start": "2020-01-02 03:04:00+00:00"
      },
      "id": "00000000-0000-1234-0000-000000000000",
      "type": "downtime_match"
    }
  ]
}

Changes

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