Get Token Metrics Over Time

get

https://api.revenium.ai/profitstream/v2/api/sources/metrics/ai/traces/tokens

Retrieve token usage metrics over time (input, output, cache read tokens) for the TokenUsageOverTimeChart component in the Claude Code dashboard

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

teamId

string

required

Unique identifier of the team (organization). Format: Revenium hashid (URL-safe encoded string).

period

string

enum

Predefined time window to aggregate results. Defaults to THIRTY_DAYS.

Allowed:

agent

string

Optional agent filter. Use to filter by specific agent (e.g., 'claude-code' for Claude Code metrics). Omit to include all agents.

start

string

Start of a custom date range in ISO 8601 format (e.g., 2025-09-01T00:00:00Z). Must be provided together with end. When both are provided, the period parameter is ignored.

end

string

End of a custom date range in ISO 8601 format (e.g., 2025-09-30T23:59:59Z). Must be provided together with start. When both are provided, the period parameter is ignored.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

200Returns token metrics over time with input, output, and cache read token counts

400Invalid input data

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Team not found

409Conflict

422Unprocessable Entity