Skip to main content
GET
/
spotlight
/
analytics
/
tokens
Token Usage Analytics
curl --request GET \
  --url https://api.app.shinzo.ai/spotlight/analytics/tokens \
  --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 session
​
model
string
Filter by model

​
Example Request

curl -X GET "https://api.app.shinzo.ai/spotlight/analytics/tokens?start_date=2025-01-01" \
  -H "Authorization: Bearer <jwt_token>"

​
Response

{
  "total_input_tokens": 125000,
  "total_output_tokens": 87500,
  "total_cache_read_tokens": 15000,
  "total_cache_creation_tokens": 8000,
  "total_requests": 450,
  "by_model": {
    "claude-sonnet-4-20250514": {
      "input_tokens": 100000,
      "output_tokens": 70000,
      "requests": 380
    },
    "claude-opus-4-20250514": {
      "input_tokens": 25000,
      "output_tokens": 17500,
      "requests": 70
    }
  }
}

​
Status Codes

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