API REFERENCE
A clean REST API over live standings, the race calendar, the driver grid, and TELOS's own AI race predictions. Built for media outlets, fantasy & betting platforms, and research teams.
Base URL & format
Format JSON · UTF-8
Methods GET (CORS enabled for browser widgets)
Authentication
Send your key as a Bearer token (or an X-API-Key header):
curl https://telos.connexastudios.com/api/v1/standings \ -H "Authorization: Bearer tlk_live_xxxxxxxxxxxxxxxxxxxx"
Rate limits
Per-minute, by tier. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over-limit returns 429 with Retry-After.
| Tier | Requests / min |
|---|---|
| Trial | 30 |
| Standard | 120 |
| Pro | 600 |
Response envelope
{
"ok": true,
"data": [ ... ],
"meta": { "api": "telos-v1", "generated_at": "2026-06-09T08:00:00+00:00" }
}
Errors: { "ok": false, "error": "rate_limited", "message": "…" } with the matching HTTP status (401 unauthorized, 422 bad param, 429 rate limited).
Endpoints
Championship standings.
| Param | Default | Notes |
|---|---|---|
| type | drivers | drivers or constructors |
| year | current | e.g. 2026 |
GET /api/v1/standings?type=drivers&year=2026
Season race calendar with status and verified winners for finished rounds.
| Param | Default |
|---|---|
| year | current |
GET /api/v1/calendar?year=2026
Current grid: drivers, teams, numbers, team colours and headshots.
GET /api/v1/drivers
TELOS AI race predictions — the frozen pre-race podium pick per round, plus the verified result and winner-hit flag once a race finishes.
| Param | Default | Notes |
|---|---|---|
| year | current | |
| session_key | — | filter to one round |
GET /api/v1/predictions?year=2026
{
"ok": true,
"data": [{
"session_key": 11307,
"gp_name": "Spain",
"prediction": { "winner": "VER", "confidence_pct": 41,
"podium": { "p1":"VER","p2":"NOR","p3":"LEC" } },
"result": { "winner": "VER", "podium": {"p1":"VER","p2":"LEC","p3":"NOR"} },
"winner_hit": true
}]
}