API Reference
Log In
API Reference

Get token usage by type

get
https://app.revenium.ai/api/v2/analytics/token-breakdown-by-type

Returns the number of tokens used per time bucket, grouped by token type: Input, Output, Cache Read and Cache Creation. The bucket size grows with the length of the range. Comparing Cache Read with Input shows how much of your prompts is served from the cache.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string | null

Start of the date range, ISO 8601 in UTC, for example 2026-01-01T00:00:00Z. Defaults to 24 hours before endDate.

string | null

End of the date range, ISO 8601 in UTC. Defaults to now.

providers
array of strings

Keep only these providers. Repeat the parameter for each provider. A single value is currently rejected with a 400, so to filter on one provider pass it twice.

providers
integer | null
≥ 0
Defaults to 0

Zero-based page of _embedded.items to return. Defaults to 0.

integer
≤ 100
Defaults to 20

Number of _embedded.items per page, from 1 to 100. Defaults to 20.

string

Hashed id of the team to answer for. Optional. With a user token it may be any team the user belongs to; without it the user's default team answers. An API key always answers for its own team, and naming any other team is refused with 403.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 1 hour ago

Did this page help you?
Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 1 hour ago

Did this page help you?