get
https://api.sportradar.com/nascar-3//races//results.
NASCAR Race Leaderboard provides detailed information concerning a drivers race performance during and after the race.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 2 seconds
Data Updates: Updates occur in near real time as drivers cross the start/finish line. Only recent crossings trigger updates.
Recommended Pull (Non-Live): Pull on an as-needed basis. Can generally be ignored until race week.
Recommended Pull (Live): Pull 5–10 minutes after an event moves to
initialized, then increase frequency when race status iswarmuporinprogress.
Tracking Live RacesLearn how to use the Race Leaderboard for live positions, lap counts, and final results in our Tracking Live Races integration scenario.
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_cautionClick here for a complete list of race conditions |
current_stage | race | Integer | Signifies the current stage of a race ex. 1, 2, 3 |
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-tbdSee 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 |
|---|---|---|---|
created_at | race - flag | String | Timestamp of a flag event ex. 2021-08-29T02:57:02+00:00 |
flag_state | race - flag | Integer | States of a flag eventwarmup, 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 Only present during a live race Should be ignored during red flags ex. 0.614 |
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 |
