Get a two-dimension usage breakdown
GoModel API reference for GET /admin/usage/breakdown: Get a two-dimension usage breakdown.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Row dimension: model, provider, user_path, label, endpoint, auth_key, period
Column dimension (same values, different from rows); omit or none for one column
Ranking metric for the top-N cut: cost, tokens, requests (default cost)
Keys kept per dimension before the rest fold into other (default 10, max 50)
Group user paths by their first N segments (0 keeps full paths, max 16)
Number of days (default 30)
Start date (YYYY-MM-DD)
End date (YYYY-MM-DD)
Period grouping: daily, weekly, monthly, yearly (default daily)
Filter by exact model names; repeat or comma-separate for several
Filter by provider names or types; repeat or comma-separate for several
Filter by request labels (exact match); repeat for several
Filter by exact request endpoints, e.g. /v1/chat/completions,/v1/messages; repeat or comma-separate for several
Filter by comma-separated operations, e.g. chat_completions,embeddings
Filter by exact detected session ID
Filter by managed auth key IDs; repeat or comma-separate for several
Filter by tracked user path subtrees; repeat for several
Cache mode filter: uncached, cached, all (default uncached)
Response
OK
, model, provider, user_path, label, endpoint, auth_key, period cost, tokens, requests , model, provider, user_path, label, endpoint, auth_key, period