Get usage breakdown by period

GET {base_url}/admin/usage/daily

Error

A valid request URL is required to generate request examples

200

[
  {
    "cache_write_input_tokens": 123,
    "cached_input_tokens": 123,
    "date": "<string>",
    "input_cost": 123,
    "input_tokens": 123,
    "output_cost": 123,
    "output_tokens": 123,
    "requests": 123,
    "total_cost": 123,
    "total_tokens": 123,
    "uncached_input_tokens": 123
  }
]

Authorizations

Authorization · string · header · required

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

Query Parameters

days · integer

Number of days (default 30)

start_date · string

Start date (YYYY-MM-DD)

end_date · string

End date (YYYY-MM-DD)

interval · string

Grouping interval: daily, weekly, monthly, yearly (default daily)

model · string

Filter by exact model name

provider · string

Filter by provider name or provider type

label · string

Filter by request label (exact match)

user_path · string

Filter by tracked user path subtree

cache_mode · string

Cache mode filter: uncached, cached, all (default uncached)

Response

200

application/json

OK

cache_write_input_tokens · integer

cached_input_tokens · integer

date · string

input_cost · number

input_tokens · integer

output_cost · number

output_tokens · integer

requests · integer

total_cost · number

total_tokens · integer

uncached_input_tokens · integer

Provider prompt-cache split of the period's input, folded per row from raw_data (same source as the summary). Zero when the storage layer does not populate them.