Skip to main content
GET
/
usage
Error
A valid request URL is required to generate request examples
{
  "total_requests": 123,
  "successful_requests": 123,
  "total_input_tokens": 123,
  "total_output_tokens": 123,
  "total_tokens": 123,
  "total_cost_usd": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

agent_id
string

Filter by agent ID

model_name
string

Filter by model name

from
string<date>

Start date (defaults to today)

to
string<date>

End date (inclusive)

group_by
enum<string>

Group results by dimension

Available options:
agent,
model,
day

Response

Usage data

total_requests
integer
successful_requests
integer
total_input_tokens
integer
total_output_tokens
integer
total_tokens
integer
total_cost_usd
number<double>