Billing Usage API (Beta)
Get paginated billing usage data for the authenticated user. DEPRECATED: This endpoint is rate limited to 10 requests per minute per user and will be removed in a future release. Use GET /api/v1/billing/usage-history instead, which provides the same data with keyset pagination. Accounts created on or after 2026-07-07 are blocked with a 410 and must use the replacement endpoint.
- 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.
Headers
Accept header to specify the response format
"application/json, text/csv"
Query Parameters
Filter by currency
USD, VCU, DIEM, BUNDLED_CREDITS "USD"
End date for filtering records (ISO 8601)
"2024-12-31T23:59:59.000Z"
Number of items per page
0 < x <= 500200
Page number for pagination
x > 01
Sort order for createdAt field
asc, desc "desc"
Start date for filtering records (ISO 8601)
"2024-01-01T00:00:00.000Z"
Response
Successful response
The response schema for the billing usage endpoint
Deprecation notice naming the replacement endpoint
This endpoint is deprecated and will be removed in a future release. Use GET /api/v1/billing/usage-history instead, which provides the same data with keyset pagination.