Escalation Dashboard

List historical escalation assignments (paginated)

GET
/api/escalation-dashboard/assignments

Returns paginated EscalationAssignment records (an audit log of every queue → agent or direct assignment), enriched with contact, assignee, and department names. Supports filtering by assignee, automation, date range, and free-text contact search.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

departmentId?string

Optional department filter. ADMIN/SUPERADMIN may pass any departmentId; DEPARTMENT_HEAD is implicitly scoped to their own department and any other value is ignored.

page?integer

1-based page number.

Range1 <= value
Default1
limit?integer

Page size. Clamped to [1, 100].

Range1 <= value <= 100
Default20
assigneeId?string
automationId?string
startDate?string
Formatdate-time
endDate?string
Formatdate-time
search?string

Case-insensitive substring match against contact firstName, lastName, or phoneNumber.value.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/escalation-dashboard/assignments"
{  "success": true,  "data": {    "assignments": [      {        "_id": "ab12cd34ef56789012345678",        "conversationId": "8c3d4e0f9a1b3c4d5e6f7a8b9c01",        "contactId": "9d4e5f1a2b3c4d5e6f7a8b9c0d12",        "contactName": "Alex Morgan",        "assigneeId": "5f7b1c2e8a1d4e0012c3b4a5",        "assigneeName": "Sam Patel",        "automationId": "5f7b1c2e8a1d4e0012c3b4a5",        "automationName": "Inbound Support",        "source": "queue",        "assignedAt": "2026-05-18T14:31:02.000Z",        "hasAccess": true      }    ],    "pagination": {      "page": 1,      "limit": 20,      "total": 143,      "totalPages": 8    }  }}