Usage Summary Csv

Download the per-model / per-user / per-key / per-source breakdown as CSV.

A dedicated route rather than a format=csv flag on /summary so that endpoint keeps a single JSON response model and a clean OpenAPI schema. The export is uncapped (no top-N fold): finance wants every row. Kept separate from the bare-array /v1/usage contract, which is untouched.

start_datestring date-time nullable

Return logs with timestamp >= start_date (ISO 8601 or Unix epoch seconds)

end_datestring date-time nullable

Return logs with timestamp < end_date (ISO 8601 or Unix epoch seconds)

user_idstring nullable

Filter to a single user

statusstring nullable

Filter to a single status (e.g. 'success' or 'error')

modelstring nullable

Filter to a single model

endpointstring nullable

Filter to a single endpoint (e.g. '/v1/chat/completions')

sourcestring nullable

Filter to a single provenance source (e.g. 'gateway' or 'claude_code')

api_key_idstring nullable

Filter to a single API key id

pricedboolean nullable

Filter by pricing state: true = only rows with a cost, false = only unpriced rows (cost is null)

counts_toward_budgetboolean nullable

Filter by budget participation: true = only enforced gateway rows, false = only imported rows that never touch a budget

Response

Successful Response

{"stackTrail":"paths:/v1/usage/summary.csv:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

v51

Usage Summary Csv

Query parameters

Response