List supervisor contract escalations
GET
/api/v1/supervisor/contracts
This endpoint returns contracts currently in the supervisor response stage and acts as the supervisor assignment queue.
While a contract remains in this queue,
escalation_deadline_at represents the supervisor deadline to assign a replacement partner, which defaults to 10 minutes unless overridden in settings.If the supervisor does not assign a replacement partner before that deadline, the contract remains
partner_pending and escalates to contract_escalation_stage = cs (customer service), with escalation_deadline_at cleared—not expired.Response body matches
GET /api/v1/partner/contracts (flat data[] of PartnerContractListItem, not institution grouped).Includes
reference_code, lifecycle status, UI display_status, contract_escalation_stage, escalation_deadline_at, and contract_escalation_countdown_active.Supervisor Authentication Required
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/supervisor/contracts?status=undefined&contract_escalation_stage=undefined&page=undefined&per_page=undefined' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Example 1
{
"success": true,
"data": [
{
"id": 0,
"reference_code": "NKT-00000042",
"status": "draft",
"display_status": "draft",
"step": "schedule",
"kind": "installation",
"contract_escalation_stage": "partner",
"escalation_deadline_at": "2019-08-24T14:15:22.123Z",
"contract_escalation_countdown_active": true,
"partner_status": "assigned",
"partner": {
"id": 0,
"full_name": "string",
"picture": "http://example.com",
"ratings_summary": {
"overall_average": 0,
"total_reviews": 0
},
"city": "string"
},
"institution": {
"id": 0,
"name": "string",
"address": "string",
"city": "string",
"province": "string"
},
"sub_service": {
"id": 0,
"name": "string"
},
"contract_start_date": "2019-08-24",
"contract_start_time": "09:30",
"contract_end_date": "2019-08-24",
"contract_end_time": "17:00",
"schedule_start_date": "2019-08-24",
"schedule_start_time": "09:30",
"schedule_end_date": "2019-08-24",
"schedule_end_time": "17:00",
"approaching_scheduled_start": true,
"seconds_until_scheduled_start": 0,
"review": {
"overall_rate": 0
},
"total_amount": {
"value": 0,
"currency": "string",
"discount_amount": 0
},
"has_pending_extension_request": true,
"payment_deadline_at": "2019-08-24T14:15:22.123Z",
"payment_status": "unpaid",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z"
}
],
"meta": {
"page": 1,
"per_page": 20,
"total_count": 100,
"total_pages": 5,
"prev_page": null,
"next_page": 2
}
}Modified at 2026-06-08 00:59:16