> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Race / Event Endpoints

> 23 endpoints for motorsport race/session data: positions, stats, odds, highlights

## Scoring Format

Motorsport uses finishing positions rather than traditional scores. The `/scores` endpoint returns:

```json theme={null}
{
  "results": [
    { "position": 1, "driver": "Verstappen", "team": "Red Bull", "time": "1:32:45.123", "gap": "" },
    { "position": 2, "driver": "Hamilton", "team": "Mercedes", "time": "1:32:49.456", "gap": "+4.333" }
  ]
}
```

<Note>Race data includes finishing positions, lap times, gaps, and pit stop counts. Qualifying sessions show lap times and grid positions.</Note>

## Race / Event Endpoints (23)

All endpoints use base URL `https://api.sportsapipro.com/v2/motorsport`.

### Race Details

```bash theme={null}
GET /api/match/:matchId                     # Full race/session details
GET /api/match/:matchId/scores              # Race positions / finishing order
GET /api/match/:matchId/lineups             # Starting grid
GET /api/match/:matchId/statistics           # Race stats (laps, times, gaps, pit stops)
GET /api/match/:matchId/incidents            # Overtakes, pit stops, retirements, safety cars
```

### Driver Statistics

```bash theme={null}
GET /api/match/:matchId/player-statistics    # All driver stats in session
GET /api/match/:matchId/player/:pid/statistics # Individual driver stats
GET /api/match/:matchId/best-players         # Top performing drivers
GET /api/match/:matchId/award                # Driver of the Day
```

### Analysis

```bash theme={null}
GET /api/match/:matchId/h2h                  # Head-to-head (teammate comparison)
GET /api/match/:matchId/graph                # Lap time progression / position graph
GET /api/match/:matchId/pregame-form         # Recent form
GET /api/match/:matchId/streaks              # Driver streaks (podiums, wins, etc.)
```

### Media & Info

```bash theme={null}
GET /api/match/:matchId/highlights           # Video highlights
GET /api/match/:matchId/media                # Race media
GET /api/match/:matchId/votes                # Fan predictions
GET /api/match/:matchId/venue                # Circuit details (length, turns, country)
GET /api/match/:matchId/missing-players      # Unavailable drivers
GET /api/match/:matchId/channels             # TV broadcast info (Sky F1, ESPN, etc.)
```

### Odds

```bash theme={null}
GET /api/match/:matchId/odds                 # Featured odds
GET /api/match/:matchId/odds/all             # All odds providers
GET /api/match/:matchId/odds/pre-match       # Pre-race odds
GET /api/match/:matchId/odds/live            # Live race odds
GET /api/match/:matchId/winning-odds         # Win probability
```