Read voice usage time series for domain

GET

/domains/{domain}/voice-usage/timeseries

Last modified:2026-10-12 18:08:01

OperationId:ReadVoiceUsageTimeseriesForDomain

Returns voice service usage as a series of time buckets across a window, for charting usage over time. Requires Reseller or Super User scope. from and to are required Unix timestamps. Set bucket to choose the bucket width and group_by to split each bucket by a dimension. Narrow the result with the optional domain, service_type, vendor, and reseller filters, where domain of * means no domain filter. Omitting from or to returns 400. This is the domain-scoped form: the report is confined to {domain} through the access-control object, so an Office Manager or higher within that domain may call it.

Request

Path Params

Query Params

Responses

🟢200

application/json

Voice usage report.

Bodyapplication/json

🟠400Err400

🟠401Err401

🟠403Err403

🟠405Err405

🔴502Err502

Request Example

Shell

JavaScript

Java

Swift

curl --location '/domains/acme.example.com/voice-usage/timeseries?from=1756684800&to=1759363200&domain=acme.example.com&service_type=transcription&vendor=deepgram&reseller=example-reseller&group_by=service_type&bucket=day'

Response Example

200 - Success Example

{
    "from": 1756684800,
    "to": 1759363200,
    "bucket": "day",
    "series": [
        {
            "timestamp": 1756684800,
            "units": 1820,
            "cost": 7.28
        },
        {
            "timestamp": 1756771200,
            "units": 1944,
            "cost": 7.78
        }
    ]
}

Modified at 2026-10-12 18:08:01

Read voice usage time series

Read voice usage by domain