Appearance
GET/v1/reports/answered/by-disconnection-causes
Answered calls grouped by disconnection cause
Per disconnection-cause (MV `event`) answered KPI buckets aligned with legacy `GET /api/v1/metrics/answered/cause`. **Aggregate vs nested calls:** bucket KPIs (`received`, `completed`, `transferred`, percentages, talk/ring/wait totals) are for the **full filter period**. `calls` lists answered calls for that cause that fall on the **current page** of the globally paginated call list (`meta`). Later pages may show empty `calls` on many buckets while KPIs stay full-period. Do not equate `calls.length` with bucket counts. Bucket objects omit `queue_name` / `queue_number`. Each `calls[]` item includes `queue_name` and `queue_number` for the call's queue. Private upstream path: `/v1/reports/answered/by-disconnection-causes`.
Parameters 9
| Name | Type | Description |
|---|---|---|
from_daterequired | query · string | Start date (DD-MM-YYYY). |
to_daterequired | query · string | End date (DD-MM-YYYY). |
from_time | query · string | Start time (HH-MM-SS). Defaults to start of day. |
Bearer token required
Response examples
200OK
{
"success_code": "OK",
"message": "OK",
"details": {},
"data": [
{
"group": "cause",
"name": "COMPLETEAGENT",
"received": 0,
"completed": 0,
"transferred": 0,
"calls_percentage": 0,
"talk_time": 0,
"talk_time_percentage": 0,
"avg_talk": 0,
"ring_time": 0,
"wait_time": 0,
"avg_wait": 0,
"max_wait": 0,
"calls": [
{
"id": "string",
"date": "string",
"agent": "string",
"agent_number": "string",
"event": "string",
"ring_time": "00:00:08",
"wait_time": "00:00:09",
"talk_time": "00:01:29",
"did": "string",
"analysis_status": "pending",
"tags": {},
"queue_name": "string",
"queue_number": "string"
}
]
}
],
"meta": {
"current_page": 0,
"per_page": 0,
"total": 0,
"last_page": 0,
"links": {
"first": "string",
"last": "string",
"prev": "string",
"next": "string"
}
}
}400Bad Request
{
"error_code": "VALIDATION_ERROR",
"message": "string",
"details": {}
}