Answered summary metrics

GET/v1/reports/answered/summary

Returns answered-call summary metrics for the selected date/time window, queues, and agents. Average talk and wait values are returned in seconds.

Query Parameters

from_datestring required

Start date (DD-MM-YYYY).

Example:06-05-2026

to_datestring required

End date (DD-MM-YYYY).

Example:17-05-2026

from_timestring

Start time (HH-MM-SS). Defaults to start of day.

Example:00-00-00

to_timestring

End time (HH-MM-SS). Defaults to end of day.

Example:23-59-59

time_zonestring

UTC offset. Defaults to +00:00 when omitted.

Example:+03:00

queuearray

Optional comma-separated queue numbers or names. Omit to include all workspace queues.

Example:1001,1002

agentarray

Optional comma-separated agent identifiers (extension number or name). Omit to include all workspace agents.

Example:2001,2002

pageinteger

Example:1

per_pageinteger

Example:25

Responses

Body

success_codeenum: 200 | 201•Numeric success code matching the HTTP response status. required

Example:200

messagestring required

Example:OK

detailsobject required

dataobject (CallCenterAnsweredSummaryData) required

answeredinteger•Count of answered and transferred calls in the filter window. required

transferredinteger required

avg_talk_secondsinteger•Average talk time in whole seconds. required

total_talk_secondsinteger•Sum of talk time in seconds. required

avg_wait_secondsinteger•Average wait time in whole seconds. required

metaobject

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

Request Sample:Shell / cURL

1
2
3
4

curl --request GET \
  --url "https://api-stg.bevatelcloud.com/v1/reports/answered/summary?from_date=06-05-2026&to_date=17-05-2026&from_time=00-00-00&to_time=23-59-59&time_zone=+03:00&queue=1001,1002&agent=2001,2002&page=1&per_page=25" \
  --header "Authorization: Bearer <YOUR_API_KEY>" \
  --header "Content-Type: application/json"

Response Example

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "success_code": 200,
  "message": "OK",
  "details": {},
  "data": {
    "answered": 0,
    "transferred": 0,
    "avg_talk_seconds": 0,
    "total_talk_seconds": 0,
    "avg_wait_seconds": 0
  },
  "meta": {}
}