Cost Controls

Get usage breakdown

Get usage broken down by a specific dimension.

Enterprise only. These routes are not registered in Community edition, which returns 404 Not Found.

get/api/v1/usage/breakdown

Request

Query parameters

group_by'provider' | 'model' | 'agent' | 'team' | 'user' required

Dimension to group by

period'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly'

Time period for aggregation

Headers

X-Org-IDstring required

Organization ID

Response

Usage breakdown

group_bystring
total_cost_usdnumber double
periodstring

Bucket label for the rolled-up period (e.g. 2026-04, 2026-W17). Same field as UsageSummary.period.

period_startstring date-time

Inclusive start of the rolled-up period.

period_endstring date-time

Exclusive end of the rolled-up period.

Changes

No recorded changes to this operation across all 1 revision of this API.