Billing
Billing Usage API (Beta)
deprecated
SUNSET as of 2026-09-16: this endpoint no longer returns usage data and answers every request with a 410. Use GET /api/v1/billing/usage-history instead, which returns the same ledger entries with cursor pagination: replace page and limit with pageSize plus the nextCursor from each response, and startDate and endDate with startTimestamp and endTimestamp.
GET
/api/v1/billing/usage
Exports usage data for a user. Descriptions of response fields can be found below:
- timestamp: The timestamp the billing usage entry was created
- sku: The product associated with the billing usage entry
- pricePerUnitUsd: The price per unit in USD
- unit: The number of units consumed
- amount: The total amount charged for the billing usage entry
- currency: The currency charged for the billing usage entry
- notes: Notes about the billing usage entry
- inferenceDetails.requestId: The request ID associated with the inference
- inferenceDetails.inferenceExecutionTime: Time taken for inference execution in milliseconds
- inferenceDetails.promptTokens: Number of tokens requested in the prompt. Only present for LLM usage.
- inferenceDetails.completionTokens: Number of tokens used in the completion. Only present for LLM usage.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
410 - application/json
Sunset on 2026-09-16. The error message names GET /api/v1/billing/usage-history and the parameters to rename.
A description of the error