v40

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-01108178385.8 KB

admin

Get usage breakdown by period

get/admin/usage/daily

Query parameters

daysinteger

Number of days (default 30)

start_datestring

Start date (YYYY-MM-DD)

end_datestring

End date (YYYY-MM-DD)

intervalstring

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

modelstring

Filter by exact model name

providerstring

Filter by provider name or provider type

labelstring

Filter by request label (exact match)

user_pathstring

Filter by tracked user path subtree

cache_modestring

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

Response

cache_write_input_tokensinteger

cached_input_tokensinteger

datestring

input_costnumber

input_tokensinteger

output_costnumber

output_tokensinteger

requestsinteger

total_costnumber

total_tokensinteger

uncached_input_tokensinteger

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.