Retrieve advanced API usage analytics
Usage
Get usage
Bucketed usage analytics with breakdowns by voice, API key, or model — ideal for dashboards and reporting.
GET
Retrieve advanced API usage analytics
Returns generated-audio minutes aggregated into time buckets, optionally broken down by voice, API key, or model. Use this for dashboards, internal reporting, and per-key attribution.
For a simpler per-voice rollup keyed by date, use Get voice usage instead.
Endpoint
Query parameters
Restrictions
voice_idandvoice_namecannot both appear inbreakdown_typein a single request.- If
start_timeandend_timehave different UTC offsets, the offset onend_timeis ignored — use matching offsets. - If
breakdown_typeis omitted, the response returns the total generated time per bucket (no per-dimension breakdown).
See also
Docs: Cost and usage
Patterns for monitoring spend in production.
Get voice usage
Simpler per-voice rollup by date.
Authorizations
Query Parameters
Start time in RFC3339 format
Example:
"2024-01-01T00:00:00+09:00"
End time in RFC3339 format
Example:
"2024-01-31T23:59:59+09:00"
Time bucket width for aggregation
Available options:
hour, day Dimensions to break down usage data
Available options:
voice_id, voice_name, api_key, model Example:
Number of results per page
Required range:
1 <= x <= 20Pagination token from previous response