APIAnalytics
List LLM sessions
Sessions ranked by cost or tokens, with per-session usage.
GET
/analytics/llm-sessionsSessions ranked by cost or tokens, with per-session usage.
Query Parameters
offset?integer
Number of items to skip before returning results.
Format
int32Range
0 <= valueDefault
0limit?integer
Maximum number of items to return per page.
Format
int32Range
0 <= value <= 20Default
10start_time*string
Start of the time range to report on, inclusive.
Format
date-timeend_time*string
End of the time range to report on, exclusive.
Format
date-timesort?string
Ordering for the session list: by cost, tokens, or recent activity.
Value in
- "cost"
- "tokens"
- "recent"
provider?array<>
Filter to specific LLM telemetry providers.
model?array<string>
Filter to specific model names.
user_id?array<>
Filter to specific users by id.
user_group?array<string>
Filter to users in specific groups.
session_key?string
Restrict to a single session (for deep links).
Response Body
application/json
application/json
curl -X GET "https://example.com/analytics/llm-sessions?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z"{ "items": [ { "session_key": "string", "provider": "claude", "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "user_name": "string", "models": [ "string" ], "tokens": 0, "by_type": [ { "type": "string", "tokens": 0 } ], "cost": 0.1, "request_count": 0, "started_at": "2019-08-24T14:15:22Z", "last_activity_at": "2019-08-24T14:15:22Z", "duration_ms": 0 } ], "meta": { "total": 0, "offset": 0, "limit": 0 }}{ "code": "bad_request", "message": "string", "validation_errors": [ { "field": "string", "message": "string", "rule": "string" } ]}