Get aggregated usage for a project
GET/api/v1/usage
Returns a project's usage rolled up over an optional [from, to] time window, bucketed by a single dimension. Each group and the grand total carry summed token counts and cost_usd (null when no event in the bucket was priced). This is the per-project cost-by-range/by-category query — a monthly figure without scanning raw meter rows client-side.
Request
Responses
- 200
- 400
- 401
- 403
The aggregated usage rollup
Bad Request (missing project_id, invalid group_by or timestamp)
Unauthorized
Forbidden