Get Token Usage

Get token usage aggregated into 15-minute buckets by user and model.

Returns usage broken down by:

input_tokens: Total input tokens
cached_tokens: Cached input tokens
new_input_tokens: New input tokens (input - cached)
output_tokens: Total output tokens
reasoning_tokens: Reasoning output tokens

Defaults to the caller's own data. Admin users (with @quadrillion.io email) may opt into cross-user data by passing user_id (specific user) or all_users=true (everyone). Non-admin requests for other users' data are silently scoped to the caller.

Passing org_id scopes the response to that organization's members and takes precedence over user_id/all_users. It requires platform admin or org admin/owner access (403 otherwise) and includes member identity in buckets.

user_idinteger nullable

Filter by user ID (admin only)

all_usersboolean

Return data for all users (admin only opt-in)

org_idinteger nullable

Scope to an organization's members (org admin only)

modelstring nullable

Filter by model name

start_datestring date-time nullable

Start date (ISO 8601)

end_datestring date-time nullable

End date (ISO 8601)

Response

Successful Response

total_input_tokensinteger required

total_cached_tokensinteger required

total_cache_write_tokensinteger required

total_new_input_tokensinteger required

total_output_tokensinteger required

total_reasoning_tokensinteger required

total_cost_usdnumber

v4

Get Token Usage

Query parameters

Response