Sign in
usage

Get global usage by provider

get/admin/v1/usage/by-provider

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /admin/v1/usage/by-provider
  • Auth: HTTP bearer

Query parameters

start_datestring nullable

Start date (YYYY-MM-DD)

end_datestring nullable

End date (YYYY-MM-DD)

record_typestring nullable

Hadrian Extension: Filter by record type: "model" (LLM requests) or "tool" (server-side tool invocations). Omit to include both.

Response

Usage breakdown by provider

audio_secondsinteger required

Hadrian Extension: Audio duration in seconds

character_countinteger required

Hadrian Extension: Character count (TTS input)

image_countinteger required

Hadrian Extension: Number of images generated

input_tokensinteger required

Input tokens used by this provider

output_tokensinteger required

Output tokens used by this provider

providerstring required

Provider name

request_countinteger required

Number of requests to this provider

total_costnumber double required

Total cost in dollars for this provider

total_tokensinteger required

Total tokens used by this provider

Changes

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