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:

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

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

Race / Event Endpoints (23)

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

Race Details

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

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

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

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

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