usage

List usage logs (admin global)

Changed on
get/admin/v1/usage/logs

Request

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

Query parameters

org_idstring uuid nullable
user_idstring uuid nullable
project_idstring uuid nullable
team_idstring uuid nullable
api_key_idstring uuid nullable
service_account_idstring uuid nullable
modelstring nullable
providerstring nullable
provider_sourcestring nullable
fromstring date-time nullable
tostring date-time nullable
limitinteger nullable
cursorstring nullable
directionstring nullable
record_typestring nullable

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

Response

List of usage log records

Example response

{
  "pagination": {
    "has_more": true,
    "limit": 100,
    "next_cursor": "MTczMzU4MDgwMDAwMDphYmMxMjM0NS02Nzg5LTAxMjMtNDU2Ny0wMTIzNDU2Nzg5YWI"
  }
}

Changes