Skip to main content

NASCAR 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
BettingEntityMetadata (From 2023)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
RecordID
from 2021
integer (32)NOT NULLNoThe ID of the record. Unique only within the same entity type (i.e. BettingMarketType Ids overlap with BettingBetType Ids).
Name
from 2021
string (100)NOT NULLNoDenotes the name of the type (e.g. Betting Market Type, Betting Event Type, Betting Period Type)
Activebool (32)NULLNoWhether or not this market is currently in use
BettingEntityMetadataCollection (From 2023)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
BettingBetTypes
from 2021
BettingEntityMetadata[] (32)NULLNoThe list of the bet types that can be found within a market (e.g. Race Winner; Top 3 Finish)
BettingMarketTypes
from 2021
BettingEntityMetadata[] (32)NULLNoA list of the possible market types within a betting event (e.g. Race Line; Drive Future)
BettingPeriodTypes
from 2021
BettingEntityMetadata[] (32)NULLNoA list of the possible period types within a betting event (e.g. Race; Truck Series; Cup Series)
BettingEventTypes
from 2021
BettingEntityMetadata[] (32)NULLNoA list of the possible BettingEventTypes
BettingOutcomeTypes
from 2021
BettingEntityMetadata[] (32)NULLNoA list of the possible betting outcomes types (e.g. Yes; No)
BettingEvent (From 2023)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
BettingEventID
from 2021
int (32)NOT NULLNoThe unique ID assocated with the betting event
Name
from 2021
string (32)NULLNoThe name of this betting event
Season
from 2021
int (32)NULLNoThe season of this betting event
BettingEventTypeID
from 2021
int (32)NOT NULLNoThe ID associated with the type of betting event
BettingEventType
from 2021
string (32)NOT NULLNoIndicates the type of betting event
StartDate
from 2021
datetimeNULLNoThe last day for betting on this event
Created
from 2021
datetimeNULLNoThe date/time when this betting event was created (in US Eastern Time)
Updated
from 2021
datetimeNULLNoThe last updated date of this betting event
RaceID
from 2021
int (32)NULLNoThe unique ID of the race tied to this event
BettingMarkets
from 2020
BettingMarket[] (32)NULLNoA list of the possible betting markets within a betting event
BettingMarket (From 2023)
Available Endpoints
NameType (Size)NullableScrambledDescription
BettingMarketID
from 2021
int (32)NOT NULLNoThe unique ID associated with the betting market
BettingEventID
from 2021
int (32)NOT NULLNoThe unique ID associated with the betting market within the betting event
BettingMarketTypeID
from 2021
int (32)NULLYesThe ID that distinguishes the different types of Market Types
BettingMarketType
from 2021
string (32)NULLYesThe name of the market type within a market (e.g. Race Prop, Driver Future, Race Line, etc.)
BettingBetTypeID
from 2021
int (32)NULLYesThe ID associated with the name of the bet type within a market
BettingBetType
from 2021
string (32)NULLYesThe name of the bet type within a market (e.g. Tournament Winner, Best Score, etc.)
BettingPeriodTypeID
from 2021
int (32)NULLYesThe BettingPeriodTypeID of this type of market which we can result
BettingPeriodType
from 2021
string (32)NULLYesThe name of the period type of this market
Name
from 2021
string (32)NULLNoThe name of this betting market
DriverID
from 2021
int (32)NULLYesThe unique ID of the driver tied to this market (if applicable)
DriverName
from 2021
string (32)NULLYesThe name of the driver tied to this market (if applicable)
Created
from 2021
datetime (32)NULLNoThe date/time when this betting market was created (in US Eastern Time)
Updated
from 2021
datetime (32)NULLNoThe last updated date of this market
AvailableSportsbooks
from 2021
Sportsbook[] (32)NULLNoThe sportsbooks that have had odds in this market
AnyBetsAvailable
from 2021
bool (32)NULLNoShows if any bets are currently available for betting in this market
BettingOutcomes
from 2021
BettingOutcome[] (32)NULLNoA list of the possible betting outcomes from each sportsbook in this market
BettingOutcome (From 2023)
Available Endpoints
NameType (Size)NullableScrambledDescription
BettingOutcomeID
from 2021
int (32)NULLNoThe unique ID associated with this specific outcome
BettingMarketID
from 2021
int (32)NULLNoThe unique ID associated with the betting market
SportsBook
from 2021
Sportsbook (32)NULLNoThe sportsbook offering this outcome for betting
BettingOutcomeTypeID
from 2021
int (32)NULLYesThe ID of this specific outcome type
BettingOutcomeType
from 2021
string (32)NULLYesThe name of betting outcome type
PayoutAmerican
from 2021
int (32)NULLYesThe American odds payout
PayoutDecimal
from 2021
decimal (32)NULLYesThe decimal odds payout
Value
from 2021
decimal (32)NULLYesThe number associated with the outcome (spread/total/etc)
Participant
from 2021
string (32)NULLNoThe name of the participant (typically team or player) associated with the outcome. NOTE: This is provided by the sportsbook. In the case of Player odds, we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks.
IsAvailable
from 2021
bool (32)NULLNoDenotes whether or not the betting outcome is currently available
IsAlternate
from 2021
bool (32)NULLNoDenotes whether or not the betting outcome is an alternate line
Created
from 2021
datetime (32)NULLNoThe date/time when this betting outcome was created (in US Eastern Time)
Updated
from 2021
datetime (32)NULLNoThe last updated date of the outcome
Unlisted
from 2021
datetime (32)NULLNoThe datetime the outcome was unlisted (no longer available for bets)
DriverID
from 2021
int (32)NULLYesThe unique ID of the driver tied to this outcome (if applicable)
SportsbookUrl
from 2021
string (500)NULLYesThe URL for sportsbook event
GroupKey
from 2021
int (32)NULLNoA key to identify outcomes which are related and part of the same offering at a sportsbook (for instance; with Group markets; this key would identify all the options for a particular group of drivers)
IsInPlayRaceOdd
from 2021
bool (32)NULLNoIndicates if this outcome is considered in-play/live (was created after the race start date)
SportsbookMarketIDstring (100)NULLYesThe market ID on the given sportsbook for deeplinking (when available)
SportsbookOutcomeIDstring (100)NULLYesThe outcome ID on the given sportsbook for deeplinking (when available)
Driver
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
DriverIDinteger (32)NOT NULLNoThe unique ID of this driver (assigned by SportsDataIO)
FirstNamestring (50)NOT NULLNoThe driver's first name
LastNamestring (50)NOT NULLNoThe driver's last name
Numberinteger (32)NULLNoThe driver's car number
NumberDisplaystring (10)NULLNoThe driver's car number for display purposes (with leading zeros when necessary)
Teamstring (100)NULLNoThe driver's team name
BirthDatedateNULLNoThe driver's birthdate
BirthPlacestring (100)NULLNoThe driver's birthplace
Genderstring (10)NULLNoThe driver's gender
Heightinteger (32)NULLNoThe driver's height
Weightinteger (32)NULLNoThe driver's weight
Manufacturerstring (50)NULLNoThe manufacturer of the driver's car
Enginestring (50)NULLNoThe engine type of the driver's car
Chassisstring (50)NULLNoThe chassis of the driver's car
Sponsorsstring (100)NULLNoThe names of the sponsor(s) of the driver
CrewChiefstring (50)NULLNoThe name of the crew chief for the driver
PhotoUrlstring (250)NULLNoThis field is deprecated. Photos are no longer available through it. Headshots are now delivered through IMAGN. Please see our Headshots products for further information.
UpdateddatetimeNULLNoThe date/time when this driver was last updated
CreateddatetimeNULLNoThe date/time when this driver was created (in US Eastern Time)
DriverBasic
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
DriverIDinteger (32)NOT NULLNoThe unique ID of this driver (assigned by SportsDataIO)
FirstNamestring (50)NOT NULLNoThe driver's first name
LastNamestring (50)NOT NULLNoThe driver's last name
Numberinteger (32)NULLNoThe driver's car number
NumberDisplaystring (10)NULLNoThe driver's car number for display purposes (with leading zeros when necessary)
Teamstring (100)NULLNoThe driver's team name
BirthDatedateNULLNoThe driver's birthdate
BirthPlacestring (100)NULLNoThe driver's birthplace
Genderstring (10)NULLNoThe driver's gender
Heightinteger (32)NULLNoThe driver's height
Weightinteger (32)NULLNoThe driver's weight
Manufacturerstring (50)NULLNoThe manufacturer of the driver's car
Enginestring (50)NULLNoThe engine type of the driver's car
Chassisstring (50)NULLNoThe chassis of the driver's car
Sponsorsstring (100)NULLNoThe names of the sponsor(s) of the driver
CrewChiefstring (50)NULLNoThe name of the crew chief for the driver
UpdateddatetimeNULLNoThe date/time when this driver was last updated
CreateddatetimeNULLNoThe date/time when this driver was created (in US Eastern Time)
DriverRace
Available Endpoints
NameType (Size)NullableScrambledDescription
StatIDinteger (32)NOT NULLNoThe unique ID of this stat record
DriverIDinteger (32)NOT NULLNoThe unique ID of this driver
Seasoninteger (32)NOT NULLNoThe season that this race is associated with
Namestring (50)NULLNoThe driver's full name
Numberinteger (32)NULLNoThe driver's car number
NumberDisplaystring (10)NULLNoThe driver's car number for display purposes (with leading zeros when necessary)
Manufacturerstring (50)NULLNoThe manufacturer of the driver's car
DraftKingsSalaryinteger (32)NULLYesThe DraftKings salary of the driver for this race
RaceIDinteger (32)NULLNoThe unique ID of this race
DaydateNOT NULLNoThe day of this race
DateTimedatetimeNULLNoThe date/time of this race
UpdateddatetimeNULLNoThe date/time when this record was last updated
CreateddatetimeNULLNoThe date/time when this record was created (in US Eastern Time)
FantasyPointsdecimal (32)NULLYesThe fantasy points scored by this driver
FantasyPointsDraftKingsdecimal (32)NULLYesThe fantasy points scored by this driver, according to the DraftKings scoring system
QualifyingSpeeddecimal (32)NULLYesThe fastest speed of this driver's car during the qualifying race
PoleFinalPositiondecimal (32)NULLYesThe final position this driver finished in the qualifying
StartPositiondecimal (32)NULLYesThe driver's starting position for the race (typically the same as the PoleFinalPosition)
FinalPositiondecimal (32)NULLYesThe driver's final position for the race
PositionDifferentialdecimal (32)NULLYesThe driver's differential between their final position and their starting position
Lapsdecimal (32)NULLYesThe total number of laps completed by the driver
LapsLeddecimal (32)NULLYesThe total number of laps that this driver completed while in first place
FastestLapsdecimal (32)NULLYesThe total number of laps that this driver finished fastest
Pointsdecimal (32)NULLYesThe total points scored by this driver
Bonusdecimal (32)NULLYesThe total bonus points scored by this driver
Penaltydecimal (32)NULLYesThe total penalty points applied to this driver
Winsdecimal (32)NULLYesIndicates whether this driver won the race
Polesdecimal (32)NULLYesIndicates whether this driver finished first in qualifying. Note this field will be either 1 (finished first) or 0 (did not finish first).
CurrentPositiondecimal (32)NULLYesDriver's current position in the race; updated live
DriverRaceBasic
Available Endpoints
NameType (Size)NullableScrambledDescription
StatIDinteger (32)NOT NULLNoThe unique ID of this stat record
DriverIDinteger (32)NOT NULLNoThe unique ID of this driver
Seasoninteger (32)NOT NULLNoThe season that this race is associated with
Namestring (50)NULLYesThe driver's full name
Numberinteger (32)NULLYesThe driver's car number
NumberDisplaystring (10)NULLYesThe driver's car number for display purposes (with leading zeros when necessary)
Manufacturerstring (50)NULLYesThe manufacturer of the driver's car
StartPositiondecimal (32)NULLYesThe driver's starting position for the race (typically the same as the PoleFinalPosition)
FinalPositiondecimal (32)NULLYesThe driver's final position for the race
PositionDifferentialdecimal (32)NULLYesThe driver's differential between their final position and their starting position
Lapsdecimal (32)NULLYesThe total number of laps completed by the driver
LapsLeddecimal (32)NULLYesThe total number of laps that this driver completed while in first place
Pointsdecimal (32)NULLYesThe total points scored by this driver
Winsdecimal (32)NULLYesIndicates whether this driver won the race
Polesdecimal (32)NULLYesIndicates whether this driver won the qualifying race (pole)
CurrentPositiondecimal (32)NULLYesDriver's current position in the race; updated live
DriverRaceOdd
Available Endpoints
NameType (Size)NullableScrambledDescription
DriverRaceOddID
from 2020
integer (32)NOT NULLNoThe unique ID of the DriverRaceOdd record
SportsbookID
from 2020
integer (32)NULLNoThe ID of the Sportsbook associated with this record
SportsbookName
from 2020
string (50)NULLYesThe name of the Sportbook
DriverName
from 2020
string (50)NULLNoThe driver's full name
DriverID
from 2020
integer (32)NULLNoThe unique ID of the driver associated with this record
OddsToWin
from 2020
integer (32)NOT NULLYesThe odds for this record, in American format i.e. +800, -200, etc.
Created
from 2020
datetimeNOT NULLNoThe date/time when this race was created (in US Eastern Time)
Updated
from 2020
datetimeNOT NULLNoThe date and time when this record was last seen from the sportsbook
IsAvailable
from 2020
boolNOT NULLNoIndicates whether the odd is available for wagering at the related Sportsbook (excludes Consensus)
SportsbookUrl
from 2020
string (500)NOT NULLNoThe URL for sportsbook event
DriverRaceProjection
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
StatIDinteger (32)NOT NULLNoThe unique ID of this stat record
DriverIDinteger (32)NOT NULLNoThe unique ID of this driver
Seasoninteger (32)NOT NULLNoThe season that this race is associated with
Namestring (50)NULLNoThe driver's full name
Numberinteger (32)NULLNoThe driver's car number
NumberDisplaystring (10)NULLNoThe driver's car number for display purposes (with leading zeros when necessary)
Manufacturerstring (50)NULLNoThe manufacturer of the driver's car
DraftKingsSalaryinteger (32)NULLYesThe DraftKings salary of the driver for this race
RaceIDinteger (32)NULLNoThe unique ID of this race
DaydateNOT NULLNoThe day of this race
DateTimedatetimeNULLNoThe date/time of this race
UpdateddatetimeNULLNoThe date/time when this record was last updated
CreateddatetimeNULLNoThe date/time when this projection record was created (in US Eastern Time)
FantasyPointsdecimal (32)NULLYesThe fantasy points scored by this driver
FantasyPointsDraftKingsdecimal (32)NULLYesThe fantasy points scored by this driver, according to the DraftKings scoring system
QualifyingSpeeddecimal (32)NULLYesThe speed of this driver's car during the qualifying race
PoleFinalPositiondecimal (32)NULLYesThe final position this driver finished in the qualifying race (pole)
StartPositiondecimal (32)NULLYesThe driver's starting position for the race (typically the same as the PoleFinalPosition)
FinalPositiondecimal (32)NULLYesThe driver's final position for the race
PositionDifferentialdecimal (32)NULLYesThe driver's differential between their final position and their starting position
Lapsdecimal (32)NULLYesThe total number of laps completed by the driver
LapsLeddecimal (32)NULLYesThe total number of laps that this driver completed while in first place
FastestLapsdecimal (32)NULLYesThe total number of laps that this driver finished fastest
Pointsdecimal (32)NULLYesThe total points scored by this driver
Bonusdecimal (32)NULLYesThe total bonus points scored by this driver
Penaltydecimal (32)NULLYesThe total penalty points applied to this driver
Winsdecimal (32)NULLYesIndicates whether this driver won the race
Polesdecimal (32)NULLYesIndicates whether this driver won the qualifying race (pole)
CurrentPositiondecimal (32)NULLYesDriver's current position in the race; updated live
FantasyRace
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
DriverIDinteger (32)NOT NULLNoThe unique ID of this driver (assigned by SportsDataIO)
Seasoninteger (32)NOT NULLNoThe season that this race is associated with
DaydateNULLNoThe day of this race
DateTimedatetimeNULLNoThe date/time of this race
Namestring (100)NULLNoThe name of this race
FantasyPointsdecimal (32)NULLNoThe fantasy points scored by this driver
FantasyPointsDraftKingsdecimal (32)NULLNoThe fantasy points scored by this driver, according to the DraftKings scoring system
UpdateddatetimeNOT NULLNoThe date/time when this race was last updated
Race
Available Endpoints
NameType (Size)NullableScrambledDescription
RaceIDinteger (32)NOT NULLNoThe unique ID of this race
SeriesIDinteger (32)NOT NULLNoThe unique ID of the series that this race is associated with
SeriesNamestring (50)NOT NULLNoThe name of the series that this race is associated with
Seasoninteger (32)NOT NULLNoThe season that this race is associated with
Namestring (100)NOT NULLNoThe name of this race
DaydateNOT NULLNoThe day of this race
DateTimedatetimeNULLNoThe date/time of this race
Trackstring (100)NULLNoThe name of the track for this race
Broadcaststring (50)NULLNoThe broadcast airing this race
WinnerIDinteger (32)NULLNoThe unique ID of the driver who won this race
PoleWinnerIDinteger (32)NULLNoThe unique ID of the driver who won the qualifying pole
IsInProgressbooleanNOT NULLNoIndicates whether this race is currently in progress
IsOverbooleanNOT NULLNoIndicates whether this race is over
UpdateddatetimeNULLNoThe date/time when this race was last updated
CreateddatetimeNULLNoThe date/time when this race was created (in US Eastern Time)
RescheduledDaydateNOT NULLNoThe day that this is race is rescheduled for (if race was postponed)
RescheduledDateTimedatetimeNULLNoThe date/time that this is race is rescheduled for (if race was postponed)
CanceledbooleanNOT NULLNoIndicates whether this race has been canceled
ScheduledLapsinteger (32)NULLNoNumber of laps scheduled for this race
ActualLapsinteger (32)NULLNoTotal number of laps ran for this race
RaceBasic
Available Endpoints
NameType (Size)NullableScrambledDescription
RaceIDinteger (32)NOT NULLNoThe unique ID of this race
DaydateNOT NULLNoThe day of this race
DateTimedatetimeNULLNoThe date/time of this race
UpdateddatetimeNULLNoThe date/time when this race was last updated
CreateddatetimeNULLNoThe date/time when this race was created (in US Eastern Time)
RaceOdds
Available Endpoints
NameType (Size)NullableScrambledDescription
RaceID
from 2020
integer (32)NOT NULLNoThe unique ID of this race
SeriesID
from 2020
integer (32)NOT NULLNoThe unique ID of the series that this race is associated with
SeriesName
from 2020
string (50)NOT NULLNoThe name of the series that this race is associated with
Season
from 2020
integer (5)NOT NULLNoThe season that this race is associated with
Name
from 2020
string (50)NULLNoThe name of this race
Day
from 2020
datetimeNULLNoThe day of this race
DateTime
from 2020
datetimeNULLNoThe date/time of this race
Track
from 2020
string (50)NULLNoThe name of the track for this race
IsInProgress
from 2020
boolNULLNoIndicates whether this race is currently in progress
IsOver
from 2020
boolNULLNoIndicates whether this race is over
PreGameOdds
from 2020
DriverRaceOdd[]NULLNoList of the odds leading up to the start of the race
RaceResult
Available Endpoints
NameType (Size)NullableScrambledDescription
RaceRaceNULLNoThe details of the race including general information about the race itself (Ex: Name; DateTime; Track; WinnerID; IsInProgress; Scheduled Laps; etc.)
DriverRacesDriverRace[]NULLNoThe details of the drivers in this race
RaceResultBasic
Available Endpoints
NameType (Size)NullableScrambledDescription
RaceRaceBasicNULLNoRaceBasic object (Includes basic information such as RaceID, Day, DateTime, Updated, and Created)
DriverRacesDriverRaceBasic[]NULLNoStatBasic object (includes basic information on the drivers race performance such as DriveID, Season, Driver's Name, Start and Final positions, Lap information, etc.)
Series
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
SeriesIDinteger (32)NOT NULLNoThe unique ID of this series
Namestring (50)NOT NULLNoThe name of this series
Sportsbook
Available Endpoints
NameType (Size)NullableScrambledDescription
SportsbookID
from 2021
int (32)NOT NULLNoThe unique ID of the sportsbook
Name
from 2021
string (50)NOT NULLYesThe name of the sportsbooks
StatBasic
NameType (Size)NullableScrambledDescription
StartPositiondecimal (32)NULLYesThe driver's starting position for the race (typically the same as the PoleFinalPosition)
FinalPositiondecimal (32)NULLYesThe driver's final position for the race
PositionDifferentialdecimal (32)NULLYesThe driver's differential between their final position and their starting position
Lapsdecimal (32)NULLYesThe total number of laps completed by the driver
LapsLeddecimal (32)NULLYesThe total number of laps that this driver completed while in first place
Pointsdecimal (32)NULLYesThe total points scored by this driver
Winsdecimal (32)NULLYesIndicates whether this driver won the race
Polesdecimal (32)NULLYesIndicates whether this driver won the qualifying race (pole)
CurrentPositiondecimal (32)NULLYesDriver's current position in the race; updated live
Tracks
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
Trackstring (100)NULLNoThe name of the track for this race
Contact Us