Page cover

Usage

Get Usage Stats

get

Get daily usage statistics for the API key's organization.

Returns paginated daily usage statistics with optional filtering by date range, model, provider, and source. Each record represents aggregated usage for a specific user/model/provider/source combination on a given date.

Query parameters
start_datestring · date-timeOptional

Start date for filtering (ISO format)

end_datestring · date-timeOptional

End date for filtering (ISO format)

modelstringOptional

Filter by specific model

model_providerstringOptional

Filter by model provider

sourcestringOptional

Filter by source (api or app)

limitinteger · min: 1 · max: 1000Optional

Number of records to return

Default: 100
offsetintegerOptional

Number of records to skip

Default: 0
Responses
200

Successful Response

application/json
get
/api/v1/usage/stats

Get Usage Summary

get

Get aggregated usage summary statistics for the API key's organization.

Returns high-level metrics including total tokens, requests, unique users, models, providers, and breakdown by API vs app usage.

Query parameters
start_datestring · date-timeOptional

Start date for summary (ISO format)

end_datestring · date-timeOptional

End date for summary (ISO format)

Responses
200

Successful Response

application/json
get
/api/v1/usage/summary
PreviousChat CompletionNextModels

Last updated