Docs/API/Usage

Usage

Aggregated usage and cost data over a time window. Group by resource, model, day, or key.

Get usage

GET/v1/usage

Aggregates usage for the calling key's organization over a time window.

Query parameters

startstringOptional

ISO 8601 date. Defaults to the first of the current month.

endstringOptional

ISO 8601 date. Defaults to today.

group_bystringOptional

One of model, resource, day, key. Default resource.

Response

json
{
  "start": "2026-04-01",
  "end":   "2026-04-16",
  "data": [
    {"resource": "transcripts", "count": 12842, "seconds": 342118, "cost_usd": 428.10},
    {"resource": "chat",        "count":  9817, "tokens": 41238291, "cost_usd": 184.73},
    {"resource": "speech",      "count":  7641, "characters": 912433, "cost_usd":  45.62}
  ],
  "total_cost_usd": 658.45
}

Costs are in the currency configured for the organization. Self-hosted deployments return usage metrics but cost_usd is null — there is no metered billing.