Token Usage Analytics
curl --request GET \
--url https://api.app.shinzo.ai/spotlight/analytics/tokens \
--header 'Authorization: Bearer <token>'Spotlight
Token Usage Analytics
Get aggregated token usage metrics.
GET
/
spotlight
/
analytics
/
tokens
Token Usage Analytics
curl --request GET \
--url https://api.app.shinzo.ai/spotlight/analytics/tokens \
--header 'Authorization: Bearer <token>'Authentication
Requires JWT token authentication.Query Parameters
string
Start date (ISO 8601)
string
End date (ISO 8601)
string
Filter by session
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
| Code | Description |
|---|---|
200 | Success |
401 | Unauthorized - invalid or missing JWT token |
400 | Bad request - invalid query parameters |