List Sessions
curl --request GET \
--url https://api.app.shinzo.ai/spotlight/analytics/sessions \
--header 'Authorization: Bearer <token>'Spotlight
List Sessions
Get a paginated list of sessions with aggregated metrics.
GET
/
spotlight
/
analytics
/
sessions
List Sessions
curl --request GET \
--url https://api.app.shinzo.ai/spotlight/analytics/sessions \
--header 'Authorization: Bearer <token>'Authentication
Requires JWT token authentication.Query Parameters
string
Start date (ISO 8601)
string
End date (ISO 8601)
string
Filter by specific session ID
string
Filter by model name
string
Filter by provider
integer
default:"25"
Results per page
integer
default:"0"
Pagination offset
string
default:"start_time"
Sort field
string
default:"desc"
Sort direction (
asc, desc)Available sort options:
start_time, end_time, total_requests, total_input_tokens, total_output_tokens, session_id.Example Request
curl -X GET "https://api.app.shinzo.ai/spotlight/analytics/sessions?limit=10&sort=total_input_tokens&sortDirection=desc" \
-H "Authorization: Bearer <jwt_token>"
Response
{
"sessions": [
{
"session_id": "my-app-session-123",
"session_uuid": "sess_abc123",
"start_time": "2025-01-15T10:00:00Z",
"end_time": "2025-01-15T11:30:00Z",
"total_requests": 15,
"total_input_tokens": 12450,
"total_output_tokens": 8320,
"total_cache_read_tokens": 2100,
"models_used": ["claude-sonnet-4-20250514"],
"providers_used": ["anthropic"]
}
],
"pagination": {
"total": 42,
"limit": 10,
"offset": 0
}
}
Status Codes
| Code | Description |
|---|---|
200 | Success |
401 | Unauthorized - invalid or missing JWT token |
400 | Bad request - invalid query parameters |