---
title: "List incidents"
method: GET
path: "/incidents"
tags: ["Incidents"]
---

# List incidents

`GET /incidents`

## Request

- Base URL: `https://app.getorchestra.io/api/engine/public`
- URL: `https://app.getorchestra.io/api/engine/public/incidents`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://app.getorchestra.io/oauth/authorize`
    - Token URL: `https://app.getorchestra.io/oauth/token` scopes: `orchestra:read`

List incidents for the workspace the credential resolves to, most severe first, with merged children nested under their parent.

Filters apply to top-level incidents only - a child is always returned alongside its parent, so a filtered list still shows the full incident rather than part of one. Use `name` to filter incidents by a case-insensitive substring match on the incident name. Use `sort_column` and `sort_direction` to sort top-level incidents by a single column instead; merged children keep the default order.

## Query parameters

- `page_size` integer
- `page` integer
- `status` string
- `severity` string
- `include_archived` boolean
- `name` string, nullable
- `created_before` string, date-time, nullable
- `sort_column` 'severity' | 'name' | 'created_at' | 'updated_at', nullable
- `sort_direction` 'asc' | 'desc'

## Headers

- `X-Orchestra-Account-Id` string, uuid4, nullable

## Response `200`

Successful Response

- PaginatedResponseIncidentResponse
  - `page` integer, required
  - `pageSize` integer, required
  - `total` integer, required
  - `results` IncidentResponse[], required
    - `incidentId` string, uuid4, required
    - `status` 'DISMISSED' | 'INVESTIGATING' | 'OPEN' | 'RESOLVED', required
    - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW', required
    - `name` string, nullable
    - `description` string, nullable
    - `assignee` string, nullable
    - `subscribers` string[]
    - `parentIncidentId` string, uuid4, nullable
    - `createdAt` string, required
    - `updatedAt` string, required
    - `resolvedAt` string, nullable
    - `resolvedBy` string, uuid4, nullable
    - `resolvedByType` 'AI' | 'API' | 'OTHER' | 'SYSTEM' | 'USER'
    - `archivedAt` string, nullable
    - `mutedAt` string, nullable
    - `isMuted` boolean
    - `mutedUntil` string, nullable
    - `monitorId` string, uuid4, nullable
    - `children` IncidentResponse[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `e45165e7e223`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getorchestra/apis/orchestra-api/changes/incidents/get.md)

---

[API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) - [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getorchestra/apis/orchestra-api/revisions/daf2c16b3057?raw)