APIAnalytics
LLM session activity
Time-bucketed token/cost activity and per-model rollup for one session.
GET
Time-bucketed token/cost activity and per-model rollup for one session.
ApiKeyAuthheader
AuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_llm_analyticsstart_time*stringStart of the time range to report on, inclusive.
Format
date-timeend_time*stringEnd of the time range to report on, exclusive.
Format
date-timesession_key*stringThe session to report on, identified by its provider session key.
provider*stringTelemetry provider of the session.
Value in
"claude""codex""gemini""copilot"The request has succeeded.
application/json- response
Time-bucketed usage plus a per-model rollup for one session.
buckets*array<>Token and cost activity over time.
models*array<>Per-model totals for the session.
curl -X GET "https://example.com/analytics/llm-session-activity?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z&session_key=string&provider=claude"{ "buckets": [ { "bucket_start": "2019-08-24T14:15:22Z", "tokens": 0, "cost": 0.1 } ], "models": [ { "model": "string", "calls": 0, "tokens": 0, "cost": 0.1, "duration_ms": 0 } ]}