Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Query Parameters

start_date
string<date>
required

Inclusive UTC calendar day at the start of the query range.

end_date
string<date> | null

Exclusive UTC calendar day at the end of the query range. Defaults to the day after the current UTC date so current-day usage is included. The date range cannot exceed 90 days.

team_ids
string[]

Return only usage for these teams, repeated once per team. Defaults to all teams you can manage. An unauthorized team ID causes a 403 response.

group_by
enum<string>[]

Pass TEAM to split daily rows by team. Defaults to aggregating across teams.

Available options:
TEAM

Response

200 - application/json

Daily server-side tool call usage, ordered by day, provider, sku, and model.

items
ToolCallUsageBucketV1 · object[]