Usage
Query aggregated usage and cost data broken down by model, session, project, or user.
Get usage summary
GET /api/v1/usage/summary
Query parameters
| Parameter | Type | Description |
|---|---|---|
from |
ISO 8601 | Start of time range |
to |
ISO 8601 | End of time range |
group_by |
string | model, session, project, user |
Response
{
"total_cost_usd": 842.30,
"total_input_tokens": 12400000,
"total_output_tokens": 3200000,
"breakdown": [
{
"key": "claude-opus-4-7",
"cost_usd": 620.10,
"input_tokens": 8000000,
"output_tokens": 2100000,
"call_count": 4820
}
]
}
Get usage records
GET /api/v1/usage/records
Paginated list of usage records. Accepts the same query parameters as /events plus group_by.