usage

Get usage summary for a user

get/admin/v1/users/{user_id}/usage

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /admin/v1/users/{user_id}/usage
Auth: HTTP bearer

user_idstring uuid required

User ID

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.

Usage summary

audio_secondsinteger required

Hadrian Extension: Audio duration in seconds

character_countinteger required

Hadrian Extension: Character count (TTS input)

first_request_atstring nullable

First request timestamp (RFC3339)

image_countinteger required

Hadrian Extension: Number of images generated

input_tokensinteger required

Input tokens used

last_request_atstring nullable

Last request timestamp (RFC3339)

output_tokensinteger required

Output tokens used

request_countinteger required

Number of requests

total_costnumber double required

Total cost in dollars

total_tokensinteger required

Total tokens used

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