---
title: "List downtimes"
method: GET
path: "/api/v2/{org_id}/downtimes"
tags: ["Downtimes"]
---

# List downtimes

`GET /api/v2/{org_id}/downtimes`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/v2/{org_id}/downtimes`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/v2/:org_id/downtimes/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the downtimes in the folders the user may list, with their status, windows and match counts.

## Path parameters

- `org_id` string, required

## Query parameters

- `folder_id` string
- `status` string
- `repeat` string
- `search` string
- `alert_id` string
- `page` integer
- `page_size` integer

## Response `200`

Success

- ListDowntimesResponse
  - `counts` DowntimeStatusCounts, required
    - `active` integer, required
    - `cancelled` integer, required
    - `ended` integer, required
    - `ended_early` integer, required
    - `recurring` integer, required
    - `scheduled` integer, required
  - `items` DowntimeListItem[], required
    - `alert_groups` AlertGroupRef[], nullable: Narrows targets to these groups; older nodes ignore it and mute the whole alert.
      - `alert_id` string, required
      - `group_key` string
      - `group_labels` object, nullable: Captured at mute time because `group_key` is a hash the UI cannot show.
    - `cancelled_at` integer, nullable
    - `cancelled_by` string, nullable
    - `condition` union: A tree of dimension tests (D17); one AND group of `=` pairs is an on-call `OwnershipRule`.
      - object
        - `items` object[], required
        - `op` 'and' | 'or', required
        - `type` 'group', required
      - object: `value` may end in `*`, a prefix, as in ownership rules.
        - `key` string, required
        - `operator` '=' | '!=', required
        - `type` 'pair', required
        - `value` string, required
    - `created_at` integer, required
    - `created_by` string, required
    - `end_on_clear` EndOnClear: "Until it clears": `group_key` null ends the downtime when no group of the alert is firing.
      - `alert_id` string, required
      - `group_key` string, nullable
    - `folder_id` string
    - `id` string, required
    - `name` string, required
    - `notifications` DowntimeNotifications
      - `continues` string, nullable: The id of the recurring downtime whose window this extension follow-up continues.
      - `destinations` string[]
      - `ending_soon_lead_secs` integer
      - `events` NotificationEvents
        - `cancelled` boolean
        - `ended` boolean
        - `ending_soon` boolean
        - `extended` boolean
        - `started` boolean
    - `org` string, required
    - `origin_region` string, nullable
    - `reason` string, nullable
    - `schedule` DowntimeSchedule, required
      - `duration_secs` integer, required
      - `ends_at` integer, nullable: Microseconds UTC; a recurring row reads only its local date, an inclusive last day.
      - `repeat` 'none' | 'daily' | 'weekly', required
      - `start_time_local` string, nullable: `HH:MM` in `timezone`, recurring rows only.
      - `starts_at` integer, required: Microseconds UTC.
      - `timezone` string, required
      - `weekdays` integer[]: ISO weekdays, 1 is Monday.
    - `show_banner` boolean: Show a warning banner to everyone in the org while a window is active (D19).
    - `source` 'slack' | 'openobserve' | 'api': Where a quick mute came from; the web app's own calls are `openobserve`.
    - `targets` DowntimeTarget[], required
      - `folders` union, required
        - object
          - `kind` 'all', required
        - object
          - `folder_ids` string[], required
          - `kind` 'some', required
      - `ids` string[]
      - `incident_mode` 'muted' | 'none': What a suppressed alert firing does to incidents during the window.
      - `module` 'alerts' | 'anomaly_detections' | 'synthetics' | 'slos', required
      - `slo_mode` 'exclude' | 'count_as_good'
      - `tags` string[]: Synthetics only.
    - `updated_at` integer, required
    - `updated_by` string, required
    - `version` integer
    - `current_window` DowntimeWindow
      - `end` integer, required
      - `start` integer, required
    - `matched_alerts` integer, required
    - `matched_anomalies` integer, required
    - `matched_slos` integer, required
    - `matched_synthetics` integer, required
    - `next_window` DowntimeWindow
      - `end` integer, required
      - `start` integer, required
    - `status` 'scheduled' | 'active' | 'ended' | 'cancelled' | 'ended_early', required
  - `total` integer, required

## Other responses

- `403`: Forbidden or not enabled

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)