Skip to main content
GET
Returns a paginated list of AI credit consumption line items — one row per provider run — equivalent to the dashboard Consumption Breakdown export. Each line includes the credits used, the USD equivalent under your account rate, the provider and service, the requestor who created the order, and the requestor’s program tags.
This endpoint is restricted to account owners and billing managers. The API key must belong to a user with the client_owner or client_accessBillings role, otherwise the request is rejected with 403.

Authorizations

This endpoint requires API key authentication. Include your API key in the request header:
  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard
  • Format: X-Api-Key: your-api-key-here
You can obtain your API key from your Ollang dashboard. The key must belong to a user with the client_owner or client_accessBillings role. Requests from keys without one of these billing roles are rejected with 403.

Query Parameters

Pagination Parameters

number
default:"1"
The page number to retrieve. Must be 1 or greater.
number
default:"10"
The number of items per page. Must be between 1 and 50.

Sorting Parameters

string
default:"id"
The field to sort the results by. Common values: occurredAt, creditsUsed, provider.
string
default:"desc"
The direction to sort the results. Options: asc, desc.

Search Parameters

A search term to filter the results across relevant fields.

Filter Parameters

Search by order name (case-insensitive contains).
string
Include consumption from this date onward (inclusive, ISO 8601 format).
string
Include consumption up to this date (inclusive, ISO 8601 format).
string
Filter by provider key, for example openai, gemini, or elevenlabs. Use the providerKey value returned on each line item.
string
Filter by order type. Values: cc, subtitle, document, aiDubbing, studioDubbing, proofreading, other, revision (see Order Types).
string
Filter by requestor. Accepts a user id or an email address.
string
Filter by a single order id.
string
Filter by a single program tag value, for example Energy Studio.

Response

array
Array of consumption line items — one row per provider run.
object
Pagination metadata.