---
title: "List the Alert Episodes of a Situation"
method: GET
path: "/situations/{id}/alert_episodes"
tags: ["Alerts"]
---

# List the Alert Episodes of a Situation

`GET /situations/{id}/alert_episodes`

## Request

- Base URL: `/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/situations/{id}/alert_episodes`
- Auth: one of:
  - `app-cookie` (defined in the document in a form this page cannot read)
  - HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

OK

- PaginatedResponseBodyAlertEpisode
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` AlertEpisode[], required
    - `attributes` AlertEpisodeAttributes, required
      - `closedAt` string, date-time
      - `definition` AlertDefinition
        - `attributes` AlertDefinitionAttributes, required
          - `definition` string, required
          - `description` string, required
          - `identityGroupLabels` string[], required: Label names that group the alert's instances
          - `knowledgeEntityId` string
          - `resolutionTimeoutSeconds` integer, required: How long after its last firing notification a window is assumed ended; 0 never
          - `roster` ExpandableOncallRosterAttributes
            - `attributes` OncallRosterAttributes
              - …
            - `id` string, required
          - `situationSignalAttention` AlertSituationSignalAttention, required
            - `level` 'default' | 'watch_only' | 'join_only', required
            - `setAt` string, date-time
          - `title` string, required
        - `id` string, required
      - `highestSeverity` 'unknown' | 'info' | 'warning' | 'critical', required
      - `instances` AlertInstance[], required
        - `attributes` AlertInstanceAttributes, required
          - `endReason` 'resolved' | 'superseded' | 'timeout'
          - `endedAt` string, date-time
          - `feedback` AlertInstanceFeedback
            - `accurate` 'yes' | 'no' | 'unknown', required
            - `actionable` boolean, required
            - `documentationAvailable` boolean, required
            - `documentationNeedsUpdate` boolean, required
            - `userId` string, required
          - `firedAt` string, date-time, required
          - `groupingKey` string, required
          - `instanceKey` string, required
          - `labels` object, required
          - `lastObservedAt` string, date-time, required
          - `severity` 'unknown' | 'info' | 'warning' | 'critical', required
          - `summary` string, required
        - `id` string, required
      - `knowledgeEntityId` string
      - `startedAt` string, date-time, required
      - `status` 'open' | 'closed', required
    - `id` string, required
  - `pagination` Pagination, required
    - `page` integer, required
    - `pageSize` integer, required
    - `total` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-08** (v1) `cb157444a05c`: 6 info
  - added the required property `code` to the response with the `400` status
  - added the required property `code` to the response with the `401` status
  - added the required property `code` to the response with the `403` status
  - added the required property `code` to the response with the `404` status
  - …2 more
- **2026-10-06** (v1) `c4c25c709446`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rezible/apis/rezible-api/changes/situations/:id/alert_episodes/get.md)

---

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