Base URL
Authentication
All requests require anx-api-key header:
Motorsport-Specific Notes
- Events are races/sessions — not matches. Each session (FP1, FP2, FP3, Qualifying, Sprint, Race) is a separate event
- Race weekends — 4-6 sessions per Grand Prix weekend (Friday-Sunday)
- Categories — Championship types (F1=36, MotoGP=1325, Moto2=1580, Moto3=1581, IndyCar=1527)
- Score format — Finishing positions (P1-P20+), championship points
- Participants — 20+ drivers/riders on track simultaneously
- Off-weekends — During breaks there may be 0 events
Race Weekend Structure
Formula 1 (typical)
| Day | Sessions |
|---|---|
| Friday | Free Practice 1, Free Practice 2 |
| Saturday | Free Practice 3, Qualifying (or Sprint Qualifying) |
| Sunday | Sprint Race (some weekends), Grand Prix |
MotoGP (typical)
| Day | Sessions |
|---|---|
| Friday | Free Practice 1, Free Practice 2 |
| Saturday | Free Practice 3, Qualifying, Sprint Race |
| Sunday | Grand Prix |
Championship Points (F1 2025+)
| Position | Points |
|---|---|
| P1 | 25 |
| P2 | 18 |
| P3 | 15 |
| P4 | 12 |
| P5 | 10 |
| P6-P10 | 8, 6, 4, 2, 1 |
| Fastest Lap (if top 10) | +1 |
Key Motorsport Statistics
| Stat | Description | Context |
|---|---|---|
| Lap Time | Time to complete one lap | Fastest lap is a key metric |
| Pit Stops | Number and duration of pit stops | Strategy indicator |
| Overtakes | Position changes during race | Excitement metric |
| Grid Position | Starting position | From qualifying |
| Gap | Time behind leader | Shows race competitiveness |
| DNF | Did Not Finish | Retirement from race |
Endpoint Categories
| Category | Count | Description |
|---|---|---|
| Live & Schedule | 7 | Live sessions, schedules |
| Search & Discovery | 7 | Search, categories, news |
| Tournament / Championship | 21 | Championship data, seasons, standings |
| Race / Event | 23 | Race details, stats, odds |
| Team / Constructor | 12 | Constructor profiles, drivers |
| Driver | 16 | Driver stats, career data |
| Team Principal / Venue | 8 | Principals, circuits |
| Total | 94 |
Example Requests
UI Design Ideas
- Starting grid view: Use
/match/{id}/lineups— show grid positions (pole position highlighted) - Race results: Show finishing order with gaps (“+5.2s”, “+1 lap”, “DNF”)
- Championship standings: Two standings — Drivers Championship and Constructors Championship
- Race calendar: Show full season calendar with circuits — use
.../rounds+.../venues - Lap chart: Use
/match/{id}/graph— show position changes lap-by-lap - Team colors: F1 teams have distinctive colors — display branding prominently
- Session types: Clearly label Practice/Qualifying/Sprint/Race — very different contexts
- DNF/DNS: Handle “Did Not Finish” and “Did Not Start” statuses
- Fastest lap: Show which driver set it — prestigious stat
- Weather: Rain transforms races — show prominently if available
MotoGP Championship Points
| Position | Points |
|---|---|
| P1 | 25 |
| P2 | 20 |
| P3 | 16 |
| P4-P15 | Decreasing scale |
Sport Comparison — Motorsport vs Other Sports
| Feature | Motorsport | Football | Tennis |
|---|---|---|---|
| Event type | Race (20+ drivers/riders) | Match (2 teams) | Match (2 players) |
| Scoring | Finishing position, championship points | Goals | Sets/games |
| Duration | Race: 1-2 hrs; Weekend: Fri-Sun | ~90 min | 1-5 hours |
| Key stats | Lap times, pit stops, overtakes | Goals, assists | Aces, winners |
| Participants | 20+ on track simultaneously | 22 (11v11) | 2 |
| Season structure | Race calendar (20-24 Grand Prix) | League + cups | Tour events |