v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
platformApi

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 }

get/api/usage-breakdowns/list/

Query parameters

breakdown_by'provider_id' | 'model' | 'deployment_name' | 'feature'
  • provider_id - Provider
  • model - Model
  • deployment_name - Deployment
  • feature - Feature
end_timestring date-time
sort_by'number_of_requests' | 'total_cost'
  • number_of_requests - Number of Requests
  • total_cost - Total Cost
start_timestring date-time

Headers

Authorizationstring required

JWT access token or Respan API key

Response

breakdown_bystring required
start_timestring required
end_timestring required