Cost Controls

Get usage summary

Get aggregated LLM usage for the current period.

Available in both Community and Enterprise editions. Basic usage overview.

get/api/v1/usage

Request

Query parameters

period'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly'

Time period for aggregation

Headers

X-Org-IDstring required

Organization ID

Response

Usage summary

total_cost_usdnumber double
total_tokens_ininteger
total_tokens_outinteger
total_requestsinteger
average_cost_per_requestnumber double
period_startstring date-time
period_endstring date-time
periodstring

Bucket label for the rolled-up period (e.g. 2026-04, 2026-W17, 2026-04-29). Echoes the request's bucket granularity so callers can label charts without parsing period_start / period_end.

Changes

No recorded changes to this operation across all 1 revision of this API.