> ## 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.

# Listar escalaciones

> Lista los casos en que un agente le pidió ayuda a una persona, filtrados por estado, miembro del equipo, tarea y fecha, con la pregunta, el motivo y el resultado.

Una escalación es un caso en que un agente le pidió ayuda a una persona. En la app, estos casos aparecen en Inbox. Consulta [Gestiona escalaciones en Inbox](/docs/es/guides/inbox/escalations).

## Elige el estado

| `status` | Devuelve | Orden |
| - | - | - |
| `open` (por defecto) | Casos que esperan a una persona. | Los más antiguos primero, así la espera más larga queda arriba. |
| `overdue` | Casos abiertos que pasaron el tiempo de respuesta esperado, que por defecto es de 6 horas. | Los más antiguos primero. |
| `resolved` | Todos los casos cerrados, sea cual sea el resultado. | Los cerrados más recientemente primero. |
| `all` | Todos los casos. | Los cerrados o creados más recientemente primero. |

En cada fila, `status` es `pending` mientras el caso está abierto, y `resolution_outcome` indica cómo se cerró, por ejemplo `resolved_manually` o `discarded`.

## Filtra la lista

| Filtro | Efecto |
| - | - |
| `assigned_to` | Solo casos cuyo lead está asignado a este ID de usuario ahora mismo. Obtén el ID en [Conteos de Inbox](/docs/es/api/inbox/get-inbox-summary) o [Desempeño del equipo](/docs/es/api/reports/get-team-performance). |
| `unassigned_only=true` | Solo casos cuyo lead no tiene un miembro del equipo asignado. Enviarlo junto con `assigned_to` devuelve 400 `conflicting_assignee_filters`. |
| `workflow_id` | Solo casos que levantó esta tarea (`workflow` en la API). |
| `date_from`, `date_to` | Solo casos creados en este rango, ambos extremos incluidos. `YYYY-MM-DD` se lee como medianoche UTC. |

`assigned_to` en la respuesta es el dueño del lead **hoy**, no el que tenía cuando se escaló.

## Recorre los resultados

`limit` va de 1 a 100 (25 por defecto) y `offset` salta filas. `total` es la cantidad de casos que cumplen los filtros en todas las páginas.

## Antes de empezar

* Las claves MCP necesitan `leads:read`. Las claves REST con acceso completo no necesitan nada más.
* Este endpoint solo lee. Para responder o cerrar un caso, usa Inbox.
* Los errores devuelven un código estable en `error`, como `invalid_status` o `invalid_limit`. Tradúcelo a tu propio mensaje.
* Una IA conectada al [servidor MCP de Nexor](/docs/es/api/mcp-server) lee la misma lista con la herramienta `list_escalations`.


## API Specification

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