Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-GoModel-Timezone
string

IANA time zone months are read in, e.g. Europe/Warsaw (default UTC)

Query Parameters

parent
string

Group whose direct children are the users, e.g. /eng (default: the credential's scope root, or /)

months
integer

Number of months ending at end_month, 1-12 (default 7: six complete months plus the current one); ignored with start_month

start_month
string

First month (YYYY-MM, default: months before end_month)

end_month
string

Last month (YYYY-MM, default and latest: the current month)

cost_basis
string

provider (default) or billed; billed requires pricing.markups_enabled

top_users
integer

List each month's N highest-cost users (0-50, default 0: aggregates only)

model
string[]

Filter by exact model names; repeat or comma-separate for several

provider
string[]

Filter by provider names or types; repeat or comma-separate for several

label
string[]

Filter by request labels (exact match); repeat for several

endpoint
string[]

Filter by exact request endpoints, e.g. /v1/chat/completions,/v1/messages; repeat or comma-separate for several

operation
string

Filter by comma-separated operations, e.g. chat_completions,embeddings

session_id
string

Filter by exact detected session ID

auth_key_id
string[]

Filter by managed auth key IDs; repeat or comma-separate for several

user_path
string[]

Filter by tracked user path subtrees; repeat for several

Response

OK

cost_basis
enum<string>
Available options:
provider,
billed
currency
string
months
object[]
parent
string
time_zone
string