Skip to Content
Analytics

LLM spend by group and model

Even-split API-equivalent spend per group × model — an estimate, not billed spend.

GET
/analytics/llm-spend-by-group-model

Even-split API-equivalent spend per group × model — an estimate, not billed spend.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

view_user_analytics

Query Parameters

scope?string

own returns only the caller's own records, even when they may see the whole organization. all, the default, returns everything the caller may see. It never widens what the caller may see.

Value in"all""own"
start_time*string

Start of the time range to report on, inclusive.

Formatdate-time
end_time*string

End of the time range to report on, exclusive.

Formatdate-time
telemetry_provider?array<>

Filter to OpenTelemetry providers; LLM gateway calls have none, so any value excludes them.

agent_slug?array<string>

Filter to agent types by catalog slug, such as claude-code.

agent_instance_id?array<>

Filter to specific agent instances.

model_provider_id?array<>

Filter to model providers: the inference connections that served the calls.

model?array<string>

Filter to specific model names.

user_group?array<string>

Filter to users in specific groups. The Unassigned ("") bucket cannot be filtered to. Narrows the even split as well as the rows, so only the selected groups come back.

auth_mode?array<>

Response Body

The request has succeeded.

application/json
  1. response

Group × model spend matrix.

items*array<>
Example Request
curl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/analytics/llm-spend-by-group-model?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z'
Example Response
{  "items": [    {      "group": "string",      "model": "string",      "cost": 0.1    }  ]}