Get usage summary

GET {base_url}/admin/usage/summary

Error

A valid request URL is required to generate request examples

200

{
  "cache_write_input_tokens": 123,
  "cached_input_tokens": 123,
  "rewrite_cost_saved": 123,
  "rewrite_tokens_saved": 123,
  "total_cost": 123,
  "total_input_cost": 123,
  "total_input_tokens": 123,
  "total_output_cost": 123,
  "total_output_tokens": 123,
  "total_requests": 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)

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

rewrite_cost_saved · number

rewrite_tokens_saved · integer

Rewrite savings: prompt tokens request rewriters removed before the provider call, and the estimated input cost avoided (nil when no matched row had a priced savings estimate).

total_cost · number

total_input_cost · number

total_input_tokens · integer

total_output_cost · number

total_output_tokens · integer

total_requests · integer

total_tokens · integer

uncached_input_tokens · integer