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

​
request_type
enum<string>

Filter by request type

Available options:
chat.completion,
embedding
​
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,
request_type

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>