Skip to main content
GET
/
admin
/
api
/
v1
/
usage
/
log
Get paginated usage log entries
curl --request GET \
  --url https://gomodel.example.com/admin/api/v1/usage/log \
  --header 'Authorization: <api-key>'
{
  "entries": [
    {
      "cache_type": "<string>",
      "costs_calculation_caveat": "<string>",
      "endpoint": "<string>",
      "id": "<string>",
      "input_cost": 123,
      "input_tokens": 123,
      "model": "<string>",
      "output_cost": 123,
      "output_tokens": 123,
      "provider": "<string>",
      "provider_id": "<string>",
      "provider_name": "<string>",
      "raw_data": {},
      "request_id": "<string>",
      "timestamp": "<string>",
      "total_cost": 123,
      "total_tokens": 123,
      "user_path": "<string>"
    }
  ],
  "limit": 123,
  "offset": 123,
  "total": 123
}

Authorizations

Authorization
string
header
required

Query Parameters

days
integer

Number of days (default 30)

start_date
string

Start date (YYYY-MM-DD)

end_date
string

End date (YYYY-MM-DD)

model
string

Filter by model name

provider
string

Filter by provider name or provider type

user_path
string

Filter by tracked user path subtree

cache_mode
string

Cache mode filter: uncached, cached, all (default uncached)

Search across model, provider, request_id, provider_id

limit
integer

Page size (default 50, max 200)

offset
integer

Offset for pagination

Response

OK

entries
object[]
limit
integer
offset
integer
total
integer