Read agent statistics

GET

/domains/{domain}/statistics/agent/{agent}

Last modified:2026-10-09 00:27:44

OperationId:GetAgentStatisticsForAgent

Returns call center statistics for one agent over a time window, across all call queues. Requires Office Manager, Call Center Supervisor, Site Manager, Reseller, or Super User scope for any agent in the domain. A Basic User or Call Center Agent can read only their own extension.

fields picks the statistics; it defaults to NAME,CH,ATT,AH,AHT,TT. Codes are case-sensitive here: send them in capitals. Add the outbound and inbound codes (OATT, OANS, OM, IA, IANS, IM) for the agent's calls outside the queues. Units follow each field's name except these: calls-queueing-avg-duration-seconds and calls-after-call-work-avg-duration-seconds are in minutes, and the outbound-*-minutes and inbound-*-minutes durations are in seconds. unit changes the units.

Without interval the response is one object. With interval, the response is a map from bucket to a map from agent extension to statistics. Bucket keys are RFC 3339 for minute, hour, and day, YYYY-Www for week, and YYYY-MM for month. Agent buckets are grouped in UTC, so leave the bracketed time zone off datetime-start here. A user who is not in the domain answers 404.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The statistics. See the description for the shape.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠420Rate Limit Exceeded

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//statistics/agent/1001?datetime-start=2026-09-01T00%3A00%3A00-07%3A00&datetime-end=2026-09-02T00%3A00%3A00-07%3A00&fields=NAME%2CCH%2CATT%2CAHT&remove_zeros=true&queue_list=2000%2C2001&interval=hour&remove_zeros_interval=true&unit=seconds&range_interval=-5%20hour' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Default fields

{
    "name": "Front Desk",
    "calls-answered-count": 42,
    "calls-talking-avg-duration-minutes": 3.42,
    "calls-holding-avg-duration-seconds": 12.5,
    "calls-handling-avg-duration-minutes": 4.38,
    "calls-talking-duration-minutes": 143.6
}

Modified at 2026-10-09 00:27:44

List agent statistics for a call queue

List dialed number statistics