---
title: "List Situations"
method: GET
path: "/situations"
tags: ["Situations"]
---

# List Situations

`GET /situations`

## Query parameters

- `page` integer
- `pageSize` integer
- `search` string
- `status` 'active' | 'investigating' | 'closed'
- `openedAfter` string, date-time

## Response `200`

OK

- PaginatedResponseBodySituation
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` Situation[], required
    - `attributes` SituationAttributes, required
      - `closeReason` 'stabilized' | 'dismissed'
      - `closedAt` string, date-time
      - `investigation` SituationInvestigation
        - `investigation` ExpandableInvestigationAttributes, required
          - `attributes` InvestigationAttributes
            - `analysisId` string, required
            - `createdAt` string, date-time, required
            - `latestTurnId` string, nullable, required
            - `latestTurnStatus` string, nullable, required
            - `query` string, required
            - `sessionId` string, required
            - `updatedAt` string, date-time, required
          - `id` string, required
      - `linkedIncidentIds` string[], required
      - `observationGroups` SituationObservationGroup[], required
        - `attributes` SituationObservationGroupAttributes, required
          - `alertEpisodes` AlertEpisode[], required
            - `attributes` AlertEpisodeAttributes, required
              - …
            - `id` string, required
          - `body` string
          - `events` Event[], required
            - `attributes` EventAttributes, required
              - …
            - `id` string, required
          - `situationId` string, required
          - `title` string, required
        - `id` string, required
      - `openedAt` string, date-time, required
      - `signalCount` integer, required
      - `summary` string, required
      - `title` string, required
      - `updatedAt` string, date-time, 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-09-25** (v1) `fddebf3187b2` — 4 breaking, 2 warning, 3 info
  - removed the required property `data/items/attributes/evidenceRevision` from the response with the `200` status
  - removed the required property `data/items/attributes/investigation/completedRevision` from the response with the `200` status
  - removed the required property `data/items/attributes/investigation/requestedRevision` from the response with the `200` status
  - removed the required property `data/items/attributes/knowledgeEntityId` from the response with the `200` status
  - …5 more
- **2026-09-16** (v1) `c5ca5495ed41` — 1 breaking, 1 info
  - removed the required property `data/items/attributes/investigations` from the response with the `200` status
  - added the optional property `data/items/attributes/investigation` to the response with the `200` status
- **2026-09-14** (v1) `a016075e69a1` — 4 breaking, 4 info
  - removed the enum value `open` from the `query` request parameter `status`
  - removed the required property `data/items/attributes/alertEpisodes` from the response with the `200` status
  - removed the required property `data/items/attributes/observationEvents` from the response with the `200` status
  - removed the required property `data/items/attributes/status` from the response with the `200` status
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/rezible/apis/rezible-api/changes/situations/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/b1e1da7c37c7?raw)
