Sign in
usage

List Usage

List usage logs ordered by timestamp (most recent first).

Supports optional filters for time range, user, status, model, and endpoint. Paginated via skip/limit. The return shape is a bare JSON array; external billing/analytics consumers depend on this, so the total row count for a paginated UI is served separately by GET /v1/usage/count rather than wrapped in an envelope here. Timestamps accept either ISO 8601 strings or Unix epoch seconds (numeric).

get/v1/usage

Query parameters

start_datestring date-time nullable

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

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)

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

user_idstring nullable

Filter to a single user

Filter to a single user

statusstring nullable

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

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

modelstring nullable

Filter to a single model

Filter to a single model

endpointstring nullable

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

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

skipinteger
limitinteger

Response

Successful Response

api_key_idstring nullable required
cache_read_tokensinteger nullable required
cache_write_tokensinteger nullable required
completion_tokensinteger nullable required
costnumber nullable required
endpointstring required
error_messagestring nullable required
idstring required
latency_msinteger nullable required
modelstring required
prompt_tokensinteger nullable required
providerstring nullable required
statusstring required
timestampstring required
total_tokensinteger nullable required
user_idstring nullable required

Changes