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
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 |

