Skip to main content
GET
/
spotlight
/
analytics
/
sessions
List Sessions
curl --request GET \
  --url https://api.app.shinzo.ai/spotlight/analytics/sessions \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.shinzo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires JWT token authentication.

​
Query Parameters

​
start_date
string
Start date (ISO 8601)
​
end_date
string
End date (ISO 8601)
​
session_id
string
Filter by specific session ID
​
model
string
Filter by model name
​
provider
string
Filter by provider
​
limit
integer
default:"25"
Results per page
​
offset
integer
default:"0"
Pagination offset
​
sort
string
default:"start_time"
Sort field
​
sortDirection
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

CodeDescription
200Success
401Unauthorized - invalid or missing JWT token
400Bad request - invalid query parameters