Skip to main content
POST
/
telemetry
/
get_usage
Usage statistics
curl --request POST \
  --url https://api.svantic.com/telemetry/get_usage \
  --header 'Content-Type: application/json' \
  --data '
{
  "summary": true,
  "range": "string",
  "group_by": "agent_type",
  "page": 1,
  "page_size": 25,
  "sort": "string",
  "order": "asc"
}
'
{
  "ok": true,
  "range": "string",
  "group_by": "string",
  "aggregates": [
    {}
  ],
  "page": 0,
  "page_size": 0,
  "total_tokens": 0,
  "total_cost": 0,
  "sessions": [
    {}
  ]
}

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.