Data Dictionary

Below you will find a list of all data points that are contained within each feed that we offer. If any of the information provided below is unclear, or if you have a specific question, please contact support.

Go to our developer portal for a full list of operations including deprecated, legacy and test endpoints.

All dates & times are in US Eastern Time.

Filter by a Subfeed...
Download CSV
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
CircuitID int 32 No No No The unique identifier for a given circuit.
Name string 100 No No No Name of the circuit.
Laps int -132 Yes No No The number of laps completed at this circuit for a full F1 race.
Turns int 32 Yes No No The number of turns in a lap of the circuit.
Type string 25 Yes No No The type of circuit. Possible values are: Street; Track; Tri-Oval; Road.
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
DriverID int 32 No No No The unique identifier for the driver.
FirstName string 50 Yes No No Driver's first name.
LastName string 50 Yes No No Driver's last name.
Status string 25 Yes No No Driver Status (Active if currently available to compete, Inactive otherwise.)
BirthDate date Yes No No Driver Date of Birth
TeamID int 32 Yes No No TeamID of current associated team (if applicable)
TeamName string 50 Yes No No Team name of currently associated team (if applicable)
Name Type Size Nullable Scrambled CSV Description
DriverID int 32 No No No The unique identifier of the associated driver.
StandingID int 32 No No No The unique identifier for the standing record in question for the given driver or team.
Season int 32 No No No Season (Year) for the standing in question.
Name string 100 No No No Friendly written name of the associated driver or team.
Points int 32 No No No Points earned in the given season (year).
Updated datetime No No No Timestamp points calculation was last performed
Name Type Size Nullable Scrambled CSV Description
QualifyingStatID int 32 No No No The unique identifier for the given qualifying stat.
RaceID int 32 No No No ID of associated Race
DriverID int 32 No No No ID of associated Driver
TeamID int 32 No No No ID of associated Team
Position int 32 Yes Yes No The position the driver takes during qualification.
Q1Time decimal Yes Yes No The time recorded for Qualification Phase 1 (Q1) . Format: 1:30:45:678 (hour:minutes:seconds.milliseconds)
Q2Time decimal Yes Yes No The time recorded for Qualification Phase 2 (Q2) . Format: 1:30:45:678 (hour:minutes:seconds.milliseconds)
Q3Time decimal Yes Yes No The time recorded for Qualification Phase 3 (Q3) . Format: 1:30:45:678 (hour:minutes:seconds.milliseconds)
Laps int 32 Yes Yes No The number of laps completed in qualifying.
DriverName string 100 Yes No No Full name of Driver
TeamName string 100 No No No Name of associated Team (Constructor)
Name Type Size Nullable Scrambled CSV Description
RacePhases RacePhase[] Yes No No List of Phases for the race (FP1, FP2, FP3, QUAL, SQ, SR, RACE)
WinnerID int 32 Yes No No DriverID of Driver who won the race
IsClosed bool No No No Indicates if final results are locked
RaceID int 32 No No No The unique identifier for the given race.
GlobalRaceID int 32 No No No A globally unique identifier for the given race.
Status string 25 No No No Status of the race. Applies to the entire race event, not just a given phase or the main race. Possible values: Scheduled, InProgress, Final.
StartDay date Yes No No Start day of the entire event, not just the main race.
EndDay date Yes No No Last scheduled day of the entire event. Usually corresponds to the day of the main race.
RaceStart datetime Yes No No Estimated start time of the main race, not of any previous phases.
CircuitID int 32 Yes No No ID of the race's home circuit.
Name string 200 No No No Name of Race Event
Name Type Size Nullable Scrambled CSV Description
SprintQualifyingStats QualifyingStat[] Yes No No Holds the QualifyingStat for Sprint Qualifier Phase (if this phase exists for the race in question.)
SprintRaceStats RaceStat[] Yes No No Holds the Race Stats for Sprint Race (if this phase exists for the race in question.)
QualifyingStats QualifyingStat[] Yes No No Holds the QualifyingStats for the main Qualifier phase for the main race.
RaceStats RaceStat[] Yes No No Holds the RaceStats for the main race phase.
RacePhases RacePhase[] Yes No No List of Phases for the race (FP1, FP2, FP3, QUAL, SQ, SR, RACE)
WinnerID int 32 Yes No No DriverID of Driver who won the race
IsClosed bool No No No Indicates if final results are locked
RaceID int 32 No No No The unique identifier for the given race.
GlobalRaceID int 32 No No No A globally unique identifier for the given race.
Status string 25 No No No Status of the race. Applies to the entire race event, not just a given phase or the main race. Possible values: Scheduled, InProgress, Final.
StartDay date Yes No No Start day of the entire event, not just the main race.
EndDay date Yes No No Last scheduled day of the entire event. Usually corresponds to the day of the main race.
RaceStart datetime Yes No No Estimated start time of the main race, not of any previous phases.
CircuitID int 32 Yes No No ID of the race's home circuit.
Name string 200 No No No Name of Race Event
Name Type Size Nullable Scrambled CSV Description
RacePhaseID int 32 No No No Unique identifier for the given phase.
RaceID int 32 No No No The RaceID (unique identifier) of this phase's associated Race.
PhaseName string 50 No No No Full name of phase type. Possible options: Free Practice 1, Free Practice 2, Free Practice 3, Sprint Qualifying, Sprint Race, Qualifying, Race.
PhaseAbbreviation string 5 No No No Abbreviation of phase type (FP1, FP2, FP3, SQ, SR, QUAL, RACE)
EstimatedStart datetime Yes No No Estimated Start time of this phase (if available)
Status string 25 No No No Status of current phase to indicate if it's yet to start, in progress, or finished. Possible options: Scheduled, InProgress, Final.
Name Type Size Nullable Scrambled CSV Description
RaceStatID int 32 No No No Unique identifier for the race stat in question.
RaceID int 32 No No No ID of the associated Race Event.
DriverID int 32 No No No ID of associated Driver
TeamID int 32 No No No ID of associated Team
Position int Yes Yes No Race finish order (or current order when the Status of the given Phase is InProgress.)
Points int 32 Yes Yes No Earned Points from this race phase results
Laps int 32 Yes Yes No Completed laps
Pits int 32 Yes Yes No Pits taken
RaceTime decimal Yes Yes No Time taken to complete race. Format: 1:30:45:678 (hour:minutes:seconds.milliseconds). This is only populated if the driver finishes the race.
DriverName string 100 Yes No No Full name of Driver
TeamName string 100 Yes No No Name of associated Team (Constructor)
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
RaceID int 32 No No No The unique identifier for the given race.
GlobalRaceID int 32 No No No A globally unique identifier for the given race.
Status string 25 No No No Status of the race. Applies to the entire race event, not just a given phase or the main race. Possible values: Scheduled, InProgress, Final.
StartDay date Yes No No Start day of the entire event, not just the main race.
EndDay date Yes No No Last scheduled day of the entire event. Usually corresponds to the day of the main race.
RaceStart datetime Yes No No Estimated start time of the main race, not of any previous phases.
CircuitID int 32 Yes No No ID of the race's home circuit.
Name string 200 No No No Name of Race Event
Name Type Size Nullable Scrambled CSV Description
StandingID int 32 No No No The unique identifier for the standing record in question for the given driver or team.
Season int 32 No No No Season (Year) for the standing in question.
Name string 100 No No No Friendly written name of the associated driver or team.
Points int 32 No No No Points earned in the given season (year).
Updated datetime No No No Timestamp points calculation was last performed
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
TeamID int 32 No No No The unique identifier for the team.
Name string 50 No No No The name of the team (aka constructor).
Active bool No No No The team's current active status. True if team is participating in current season, False otherwise.
Name Type Size Nullable Scrambled CSV Description
TeamID int 32 No No No The unique identifier of associated team (aka constructor).
StandingID int 32 No No No The unique identifier for the standing record in question for the given driver or team.
Season int 32 No No No Season (Year) for the standing in question.
Name string 100 No No No Friendly written name of the associated driver or team.
Points int 32 No No No Points earned in the given season (year).
Updated datetime No No No Timestamp points calculation was last performed
Contact Us