F1 Workflow Guide
Competition Feeds
Standings, Rankings & Brackets
Driver Standings
Driver championship standings are updated after each race weekend to reflect the latest point totals. The DriverStanding endpoint is called by Season and returns the driver information and current season point total.
Team Standings
Team championship standings aggregate points scored by both drivers for each team. The TeamStanding endpoint is called by Season and delivers the team information and current season point total.
Teams, Players & Rosters
Drivers
Driver profiles provide key biographical information for all Formula 1 drivers. Profile information includes first name, last name, date of birth, current team affiliation, and status. Drivers with a status of Active are part of the current F1 grid. Drivers with an Inactive status are reserve drivers or not currently affiliated with a team.
Teams
Team profiles provide team names for all F1 teams, as well as the current status (Active/Inactive). Teams with a status of Active are currently part of the F1 grid for the current season. Teams with an Inactive status are not currently part of the grid.
Venues & Officials
Circuits
SportsDataIO confirms all upcoming circuits scheduled to host an F1 race at the beginning of each season. Circuit data is updated when the schedule is initially released each season. Circuit records include name, number of laps, number of turns, and circuit type (Track, Road, Street, or Tri-Oval).
Event Feeds
Schedules
The Formula 1 schedule is typically released in the Fall for the upcoming calendar year season. Once the official schedule is released, SportsDataIO updates Schedule records for upcoming races, typically within a few hours of the schedule release.
Each schedule record contains information for the full race weekend. Each record contains a start day, end day, race start time, circuit information, and status. Note that the Schedule endpoint is geared towards high-level event information. For more detailed race info, including race phases, we recommend using Races - by RaceID or Races - by Season.
Scores & Game State
Each race on the Formula 1 schedule has multiple race phases.
For a typical non-sprint race, the phases are as follows:
- Free Practice 1
- Free Practice 2
- Free Practice 3
- Qualifying
- Race
For a select number of races on the F1 schedule, they implement a Sprint format, resulting in the following phases:
- Free Practice 1
- Sprint Qualifying
- Sprint Race
- Qualifying
- Race
Race phases are delivered through our Races - by RaceID and Races - by Season endpoints. Each RacePhase record has the phase name, abbreviation, estimated start time, and status.
Team & Player Stats
SportsDataIO provides comprehensive F1 coverage through live leaderboards, race status updates, and final results for each phase of the race weekend. Race stats are broken down for each race phase.
Qualifying times are split into three sessions - Q1, Q2, and Q3.
In Q1, all 22 drivers compete and the slowest 6 are eliminated. In Q2, the remaining 16 drivers compete, with the slowest 6 being eliminated. Finally, in Q3, the top 10 drivers compete for pole position.
Our qualifying stats deliver the times of each session. Drivers who were eliminated prior to Q3 will have a NULL time, due to the fact they did not participate in that session. Please note that all qualifying times are delivered in milliseconds, allowing the flexibility to format the timestamp based on your use case.
Race stats include the driver's current position on the leaderboard, number of laps completed, and number of pits. Leaderboard data updates routinely as the race unfolds.
After the race has concluded, post-race inspections commence. The WinnerID is populated on the Race record, the final race times are finalized for all racers who completed the maximum number of laps, and the total points accrued for that race are added to each drivers RaceStat record within about 15 minutes post-race once inspections are completed. Points are then aggregated in the Standings endpoints to show the updated season-long totals. Again, please note that RaceTime values are delivered in milliseconds.
