Race Leaderboard

⏱️
Update Frequency
2s Time To Live / Cache

Data Points

Race:

Attribute	Parent Element	Type	Description
`actual_distance`	`race`	Boolean	The actual amount of mileage ran for a race
`start_time`	`event` - `race`	dateTime	Original TV broadcast start time of a race ex. `2022-09-04T22:00:00+00:00`
`end_time`	`event` - `race`	dateTime	Original TV broadcast end time of a race ex. `2022-09-05T02:00:00+00:00`
`award_pole`	`race`	Boolean	Signifies a race provides a pole award for the first driver
`cautions`	`race`	Integer	Number of cautions in a race
`caution_laps`	`race`	Integer	Number of caution laps in a race
`chase_race`	`race`	Boolean	Signifies a race is part of the playoffs
`comments`	`race`	String	Text description/recap of a race event ex. `Austin Cindric has won the DAYTONA 500 at Daytona International Speedway...`
`condition`	`race`	String	Current racing condition at the track ex. `normal`, `conditions_caution` Click here for a complete list of race conditions
`distance`	`race`	Integer	Distance of a race in miles
`elapsed_time`	`race`	String	Time of a race in HH:MM:SS ex. `3:31:53`
`heat_race`	`race`	Boolean	Signifies a race is a heat race
`id`	`race`	GUID	Unique ID of a race ex. `24ba9219-ebe8-4e1f-a21c-71edfd9aaf44`
`laps`	`race`	Integer	Number of laps in a race
`laps_completed`	`race`	Integer	Number of laps completed by the leader in a race
`lead_changes`	`race`	Integer	Number of lead changes in a race
`name`	`race`	String	Name of a race ex. `DAYTONA 500`
`number`	`race`	Integer	Race number within a season
`parent_id`	`race`	GUID	Unique ID that links events together across seasons (e.g. Daytona 500) ex. `de3f49e0-9393-4d7e-b5a5-3cf5b94a9f38`
`purse`	`race`	Decimal	Purse of a race. Note: This is no longer supported in years 2016 or later.
`scheduled`	`race`	dateTime	Scheduled date and time of a race ex. `2022-02-20T19:30:00+00:00`
`stage_1_laps`	`race`	Integer	Number of laps in stage 1
`stage_2_laps`	`race`	Integer	Number of laps in stage 2
`stage_3_laps`	`race`	Integer	Number of laps in stage 3
`stage_count`	`race`	Integer	Number of stages in which a driver can earn stage points
`status`	`race`	String	Race status `scheduled`, `created`, `initialized`, `practice`, `qualifying`, `prerace`, `inprogress`, `complete`, `closed`, `delayed`, `canceled`, `rescheduled`, `maintenance`, `warmup`, `time-tbd` See our FAQ to find a list of statuses and their definitions
`victory_margin`	`race`	Decimal	Margin of victory in a race ex. `.036`

Race Flag State:

Attribute	Parent Element	Type	Description
`flag_state`	`race` - `flag`	Integer	States of a flag event `warmup`, `green`, `yellow`, `red`, `finish`
`lap`	`race` - `flag`	Integer	Lap number of a flag event
`sequence`	`race` - `flag`	Integer	Sequence number of a flag event
`comments`	`race` - `flag`	String	Text description of a flag event, including car numbers involved ex. `<![CDATA[#2, 14, 50 Incident Turn 2]]>`
`beneficiary`	`race` - `flag`	String	Car number of a beneficiary (car which earns a lap) of a flag event ex. `<![CDATA[16 ]]>`

Track:

Attribute	Parent Element	Type	Description
`backstretch`	`track`	Integer	Backstretch length of a track in feet
`banking`	`track`	String	Banking information of a track ex. `Turns: 31, Tri-Oval: 18, Backstretch: 3`
`distance`	`track`	Float	Track length in miles ex. `2.66`
`frontstretch`	`track`	Integer	Backstretch length of a track in feet
`id`	`track`	GUID	Unique ID of a track ex. `6ff97f68-2e9d-4fe6-8cd8-2969e1d3570b`
`lat`	`track`	Decimal	Latitude of a track ex. `29.192994`
`lng`	`track`	Decimal	Longitude of a track ex. `-81.067`
`name`	`track`	String	Name of a track ex. `Daytona International Speedway`
`shape`	`track`	String	Shape of a track ex. `Oval` or `D-Shaped Oval`

Cars:

Attribute	Parent Element	Type	Description
`id`	`result` - `car`	GUID	Unique ID of a car ex. `9b6f938a-37c6-4416-8d8c-b4ad6aa7e8a0`
`number`	`result` - `car`	Integer	Number of a car
`crew_chief`	`result` - `car`	String	Crew chief for a car ex. `Paul Wolfe`
`sponsors`	`result` - `car`	String	Sponsors for a car ex. `Shell Pennzoil/AAA Southern California`
`id`	`result` - `car` - `manufacturer`	GUID	Unique ID of a manufacturer ex. `73364deb-a012-4625-b759-db6a236797e3`
`name`	`result` - `car` - `manufacturer`	String	Name of a manufacturer ex. `Toyota`
`id`	`result` - `car` - `owner`	GUID	Unique ID of a car owner ex. `03246399-5e63-4c21-9c5f-24074e3bf515`
`name`	`result` - `car` - `owner`	String	Name of a car owner ex. `Walter Czarnecki`

Drivers:

Attribute	Parent Element	Type	Description
`first_name`	`driver`	String	First name of a driver ex. `Kevin`
`full_name`	`driver`	String	Full name of a driver ex. `Kevin Harvick`
`id`	`driver`	GUID	Unique ID of a driver ex. `9d18716c-fd73-48d4-b3da-44228c767b84`
`in_chase`	`driver`	Boolean	Signifies a driver is in playoff contention
`last_name`	`driver`	String	Last name of a driver ex. `Harvick`
`points_eligible`	`driver`	Boolean	Signifies a driver is eligible for points in a series

Teams:

Attribute	Parent Element	Type	Description
`id`	`result` - `car` - `team`	GUID	Unique ID of a team ex. `e337709c-9fb6-4275-ad89-d9c100e71a1d`
`name`	`result` - `car` - `team`	String	Name of a team ex. `Team Penske`
`id`	`result` - `car` - `team` - `owner`	GUID	Unique ID of a team owner ex. `57198af5-d912-4efc-9135-95fc6c0a3fc5`
`name`	`result` - `car` - `team` - `owner`	String	Name of a team owner ex. `Roger Penske`

Race Statistics:

Attribute	Parent Element	Type	Description
`avg_position`	`result`	Decimal	Average position for a driver in a race ex. `6.249`
`avg_restart_speed`	`result`	Decimal	Average speed for a driver on restarts ex. `182.706`
`avg_speed`	`result`	Decimal	Average speed for a driver in a race ex. `142.302`
`behind_leader`	`result`	Decimal	Delta of a driver behind the leader Live statistic only
`best_lap`	`result`	Integer	Best lap of a race for a driver ex. `188`
`best_lap_speed`	`result`	Decimal	Highest lap speed for a driver during a race ex. `195.219`
`best_lap_time`	`result`	Decimal	Fastest lap time for a driver in a race ex. `46.102`
`bonus_points`	`result`	Integer	Total stage 1 points + stage 2 points
`driver_rating`	`result`	Decimal	Driver rating for a race (0-150)
`elapsed_time`	`result`	Decimal	Total time of a race in HH:MM:SS ex. `2:58:42`
`fastest_lap_points`	`result`	Integer	Point(s) awarded, for driver and car, for recording the fastest lap in a points-paying race.
`fastest_laps`	`result`	Integer	Number of laps in which a driver was the fastest during a race
`laps_behind`	`result`	Decimal	Lap delta of a driver behind the leader (if 1 or more laps behind) Live statistic only
`laps_completed`	`result`	Integer	Number of laps completed in a race for a driver ex. `201`
`last_lap_speed`	`result`	Decimal	Highest speed for a driver during their final lap ex. `190.682`
`last_lap_time`	`result`	Decimal	Lap time for a driver for their final lap ex. `47.199`
`money`	`result`	Integer	Money earned. Note: This is no longer supported in years 2016 or later.
`penalty_points`	`result`	Integer	Points deducted after a race weekend
`points`	`result`	Integer	Total points earned for a race
`position`	`result`	Integer	Current position of a driver in a race
`status`	`result`	String	Driver result status See our FAQ for a complete list of result statuses and their descriptions
`stage_1_points`	`result`	Integer	Total points earned during stage 1 (1-10)
`stage_1_win`	`result`	Boolean	Signifies a stage 1 win for a driver
`stage_2_points`	`result`	Integer	Total points earned during stage 2 (1-10)
`stage_2_win`	`result`	Boolean	Signifies a stage 2 win for a driver
`stage_3_points`	`result`	Integer	Total points earned during stage 3 (1-10)
`stage_3_win`	`result`	Boolean	Signifies a stage 3 win for a driver
`start_position`	`result`	Integer	Starting position for a driver in a race
`times_led`	`result`	Integer	Number of times leading a race for a driver

Laps Led:

Attribute	Parent Element	Type	Description
`laps_led`	`result`	Integer	Number of laps led in a race for a driver ex. `21`
`sequence`	`result` - `laps-led` - `lead`	Integer	Sequence number for a laps led entry
`start_lap`	`result` - `laps-led` - `lead`	Integer	Lap number for the beginning of a laps led entry ex. `157`
`end_lap`	`result` - `laps-led` - `lead`	Integer	Lap number for the end of a laps led entry ex. `162`

Pit Stops:

Attribute	Parent Element	Type	Description
`pit_stops`	`result`	Integer	Number of pit stops in a race for a driver ex. `8`
`in_time`	`result` - `pit-stops` - `pit-stop`	Decimal	Race time a driver began a pit stop ex. `1754.495`
`lap`	`result` - `pit-stops` - `pit-stop`	Integer	Lap number of a pit stop
`leader_lap`	`result` - `pit-stops` - `pit-stop`	Integer	Leader lap number of a pit stop
`out_time`	`result` - `pit-stops` - `pit-stop`	Decimal	Race time a driver ended a pit stop ex. `1754.495`
`positions_gained`	`result` - `pit-stops` - `pit-stop`	Integer	Number of positions gained or lost during a pit stop ex. `4` or `-7`
`sequence`	`result` - `pit-stops` - `pit-stop`	Integer	Sequence number for a pit stop entry