Skip to main content
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 as invalid_status or invalid_limit. Map the code to your own copy.
  • An AI connected to the Nexor MCP server reads the same list with the list_escalations tool.

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Query Parameters

status
enum<string>
default:open

open: waiting for a person. overdue: open and past the expected response time. resolved: every closed case, whatever the outcome. all: every case.

Available options:
open,
overdue,
resolved,
all
assigned_to
string<uuid>

Only escalations whose lead is currently assigned to this user ID. Cannot be combined with unassigned_only.

unassigned_only
boolean
default:false

true returns only escalations whose lead has no assigned teammate.

workflow_id
string<uuid>

Task ID (workflow in the API). Only escalations raised by this task. A malformed ID returns 400 invalid_workflow_id, and a task outside this account returns 404 workflow_not_found.

date_from
string<date-time>

Only escalations created at or after this time. Accepts YYYY-MM-DD (read as midnight UTC) or an ISO 8601 date-time.

date_to
string<date-time>

Only escalations created at or before this time. Accepts YYYY-MM-DD (read as midnight UTC) or an ISO 8601 date-time.

limit
integer
default:25

Page size.

Required range: 1 <= x <= 100
offset
integer
default:0

Rows to skip.

Required range: x >= 0

Response

A page of escalations and the total that match.

success
enum<boolean>
required
Available options:
true
status
enum<string>
required

The status filter applied.

Available options:
open,
overdue,
resolved,
all
total
integer
required

Escalations that match the filters, across every page.

Required range: x >= 0
limit
integer
required
Required range: 1 <= x <= 100
offset
integer
required
Required range: x >= 0
escalations
object[]
required
Last modified on September 29, 2026