API ReferencePlatform API

Api Usage Breakdowns List Retrieve

GET /api/usage-breakdowns/list/ Usage cost and request breakdown by dimension. The breakdown_by param selects the grouping dimension (provider_id, model, deployment_name, or feature). Defaults to current billing period. When breakdown_by=feature, returns logging vs proxy cost split. All other values query ClickHouse aggregations. Query params: breakdown_by, sort_by, start_time, end_time, org (superadmin). Response: { breakdown_by, breakdown_items, summary, billing_periods, start_time, end_time }

Authentication

AuthorizationBearer
JWT access token or Respan API key

Query parameters

breakdown_byenumOptionalDefaults to provider_id
* `provider_id` - Provider * `model` - Model * `deployment_name` - Deployment * `feature` - Feature
Allowed values:
end_timedatetimeOptional
sort_byenumOptionalDefaults to number_of_requests
* `number_of_requests` - Number of Requests * `total_cost` - Total Cost
Allowed values:
start_timedatetimeOptional

Response

breakdown_bystring
breakdown_itemslist of objects
summaryobject
Totals across all breakdown rows.
billing_periodslist of objects
start_timestring
end_timestring