Skip to main content
POST
Usage statistics

Body

application/json
summary
boolean

Return aggregated summary instead of records.

range
string

Time range: '24h', '7d', '30d' (default '7d').

group_by
enum<string>

Aggregate dimension.

Available options:
agent_type,
model
page
integer
default:1
Required range: x >= 1
page_size
integer
default:25
Required range: 1 <= x <= 100
sort
string

Sort field (default 'tokens').

order
enum<string>

Sort order (default 'desc').

Available options:
asc,
desc

Response

Usage data.

ok
boolean
required
range
string
required
group_by
string
aggregates
object[]

Present when group_by is specified.

page
integer
page_size
integer
total_tokens
integer

Present in summary mode.

total_cost
number

Present in summary mode.

sessions
object[]

Present in per-session mode.