Developers · v1

API REFERENCE

F1 data, programmatically

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.

Keys are issued on a contract basis. Tell us your use case and volume — we'll set you up with a key and a tier.

GET A KEY →

Base URL & format

Base URL https://telos.connexastudios.com/api/v1
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

GET/standings

Championship standings.

Param	Default	Notes
type	drivers	`drivers` or `constructors`
year	current	e.g. 2026

GET /api/v1/standings?type=drivers&year=2026

GET/calendar

Season race calendar with status and verified winners for finished rounds.

Param	Default
year	current

GET /api/v1/calendar?year=2026

GET/drivers

Current grid: drivers, teams, numbers, team colours and headshots.

GET /api/v1/drivers

GET/predictions

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
  }]
}

GET/next-race

The next Grand Prix with a live countdown (seconds_to_lights) and TELOS's pre-race AI podium pick when published. Rolls into next season automatically once the calendar ends. Perfect for a "next race" widget.

GET /api/v1/next-race

{
  "ok": true,
  "data": {
    "name": "Canadian Grand Prix",
    "circuit": "Montreal",
    "country": "Canada",
    "date_start": "2026-06-14T18:00:00+00:00",
    "seconds_to_lights": 86400,
    "prediction": { "winner": "VER", "confidence_pct": 38,
                    "podium": { "p1":"VER","p2":"NOR","p3":"RUS" } }
  }
}

GET/accuracy

TELOS AI track record — winner hit-rate and podium accuracy for both pre-race and live picks, scored only against verified finishes. Great as a "social proof" badge.

Param	Default	Notes
year	all-time	scope to one season

GET /api/v1/accuracy?year=2026

{
  "ok": true,
  "data": {
    "races_evaluated": 9,
    "pre_race": { "winner_hit_rate_pct": 44.4, "podium_accuracy_pct": 70.4 },
    "live":     { "winner_hit_rate_pct": 66.7, "podium_accuracy_pct": 81.5 }
  }
}

Ready to build? Request a key and we'll get you a sandbox tier the same day.

CONTACT SALES →