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.
GET
List escalations
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.
Choose the status
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
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 asinvalid_statusorinvalid_limit. Map the code to your own copy. - An AI connected to the Nexor MCP server reads the same list with the
list_escalationstool.
Authorizations
Query Parameters
Response
A page of escalations and the total that match.
Last modified on October 14, 2026
List escalations