Escalation Dashboard
List historical escalation assignments (paginated)
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.
Range
1 <= valueDefault
1limit?integer
Page size. Clamped to [1, 100].
Range
1 <= value <= 100Default
20assigneeId?string
automationId?string
startDate?string
Format
date-timeendDate?string
Format
date-timesearch?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 } }}