API ReferenceBilling

Payment Usage Breakdown Retrieve

GET /payment/usage-breakdown/

Cost and request breakdown by a chosen dimension (provider, model, deployment, or feature). Available dimensions are defined in payment.usage_breakdown.BREAKDOWN_DIMENSIONS.

Query params: breakdown_by, sort_by, start_time, end_time. 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