Read domain CDR statistics

GET

/domains/{domain}/cdrs/stats

Last modified:2026-10-09 00:34:07

OperationId:ReadCdrStatsDomain

Returns one domain's call counts and talk time as a time series, one point per bucket. Requires Office Manager, Office Manager Read-Only, Call Center Supervisor, or Route Manager scope for your own domain, Reseller scope for a domain in your territory, or Super User or Super User Read Only scope.

Set the window with range, which ends now and defaults to 24h, or with both start_date and end_date, which take precedence. datetime-start and datetime-end are accepted as the same pair. The bucket size follows the window unless you set period, and more than 5,000 buckets returns 400. Every bucket is returned, with 0 where there were no calls, and count_only=yes leaves out minutes and seconds for a faster answer.

Rows hidden with hide-from-results are not counted. Months moved to archive storage are skipped by default, so a window that reaches into them undercounts. Use GET /cdrs/stats for a territory or the whole platform, and GET /domains/{domain}/cdrs/count for one total.

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

🟢200

application/json

The time series.

Bodyapplication/json

🟠400

🟠401Authentication Required

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//cdrs/stats?range=24h&start_date=2026-09-01T12%3A00%3A00+00%3A00&end_date=2026-09-01T14%3A30%3A00+00%3A00&period=hour&type=Inbound&count_only=yes' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Three hours by hour

start_date=2026-09-01T12:00:00+00:00&end_date=2026-09-01T14:30:00+00:00&period=hour.

{
    "domain": "example.com",
    "period": "hour",
    "start-datetime": "2026-09-01T12:00:00+00:00",
    "end-datetime": "2026-09-01T14:00:00+00:00",
    "data-points": [
        {
            "timestamp": 1788264000,
            "datetime": "2026-09-01T12:00:00+00:00",
            "calls": 42,
            "minutes": 131,
            "seconds": 7812
        },
        {
            "timestamp": 1788267600,
            "datetime": "2026-09-01T13:00:00+00:00",
            "calls": 57,
            "minutes": 190,
            "seconds": 11378
        },
        {
            "timestamp": 1788271200,
            "datetime": "2026-09-01T14:00:00+00:00",
            "calls": 18,
            "minutes": 49,
            "seconds": 2903
        }
    ]
}

Modified at 2026-10-09 00:34:07

Update user CDR

Read CDR statistics