> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List escalations

> List the cases where an agent asked a person for help, filtered by status, teammate, task and date, with the question, the reason and the outcome.

An escalation is a case where an agent asked a person for help. In the app, these cases appear in Inbox. See [Handle escalations in Inbox](/docs/en/guides/inbox/escalations).

## Choose the status

| `status` | Returns | Order |
| - | - | - |
| `open` (default) | Cases waiting for a person. | Oldest first, so the longest wait is on top. |
| `overdue` | Open cases that passed the expected response time, 6 hours by default. | Oldest first. |
| `resolved` | Every closed case, whatever the outcome. | Most recently closed first. |
| `all` | Every case. | Most recently closed or created first. |

In each row, `status` is `pending` while the case is open, and `resolution_outcome` says how it closed, for example `resolved_manually` or `discarded`.

## Filter the list

| Filter | Effect |
| - | - |
| `assigned_to` | Only cases whose lead is assigned to this user ID right now. Get the ID from [Inbox summary](/docs/en/api/inbox/get-inbox-summary) or [Team performance](/docs/en/api/reports/get-team-performance). |
| `unassigned_only=true` | Only cases whose lead has no assigned teammate. Sending it with `assigned_to` returns 400 `conflicting_assignee_filters`. |
| `workflow_id` | Only cases raised by this task (`workflow` in the API). |
| `date_from`, `date_to` | Only cases created in this range, both ends included. `YYYY-MM-DD` is read as midnight UTC. |

`assigned_to` in the response is the lead's owner **today**, not at the time of the escalation.

## Page through results

`limit` goes from 1 to 100 (default 25) and `offset` skips rows. `total` is the number of cases that match the filters across every page.

## Before you start

* MCP keys need `leads:read`. Full-access REST keys need nothing else.
* This endpoint only reads. To reply to or close a case, use Inbox.
* Errors return a stable code in `error`, such as `invalid_status` or `invalid_limit`. Map the code to your own copy.
* An AI connected to the [Nexor MCP server](/docs/en/api/mcp-server) reads the same list with the `list_escalations` tool.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).