List Sessions

Get a paginated list of sessions with aggregated metrics.

GET /spotlight/analytics/sessions

List Sessions

cURL

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

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

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