Read per-minute call queue gauges for the last hour or two

Developing

GET

/domains/{domain}/statistics/callqueues/live-history

Last modified:2026-10-20 19:49:56

OperationId:ReadCallqueueLiveHistory

One point per minute, from range ago up to the current (partial) minute, oldest first. Each point gives every covered queue's values for that minute (the highest it reached during the minute) and a domain-wide *.

The queues covered are the ones the caller may see in the other call center statistics, narrowed by queue_list. A Site Manager sees only the queues of its own site. Agent-level scopes (Basic User, Call Center Agent and the like) may read only their own agent statistics and get 403 here.

Each core server keeps its own samples, so the read asks every core and, per queue, takes the larger of the cores' values. A core that does not answer is left out and named in the X-NS-Fanout-Missing response header; the values then cover the other cores only, and the response is still 200.

Available when the platform has call center reports enabled; 404 otherwise.

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 per-minute series

Headers

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//statistics/callqueues/live-history?range=undefined&queue_list=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "domain": "example.com",
    "range": "1h",
    "period": "minute",
    "start": 1792080060,
    "end": 1792083600,
    "start-datetime": "2026-10-15T16:01:00+00:00",
    "end-datetime": "2026-10-15T17:00:00+00:00",
    "oldest-available": 1792071000,
    "oldest-available-datetime": "2026-10-15T13:30:00+00:00",
    "queues": [
        "4000",
        "4001"
    ],
    "data-points": [
        {
            "timestamp": 1792080060,
            "datetime": "2026-10-15T16:01:00+00:00",
            "queues": {
                "4000": {
                    "callers-waiting": 1,
                    "longest-wait-seconds": 32,
                    "sessions": 2,
                    "agents-total": 47,
                    "agents-available": 22,
                    "agents-unavailable": 25
                }
            },
            "*": {
                "callers-waiting": 0,
                "longest-wait-seconds": 0,
                "sessions": 0,
                "agents-total-max": 0,
                "agents-available-max": 0,
                "agents-unavailable-max": 0
            }
        }
    ]
}

Modified at 2026-10-20 19:49:56

Read an agent's status timeline

Read 15-minute, hourly or daily call queue history