Categories

Coverage
Race Statuses
Race Conditions
Heat Races

Integration
Driver Statuses
Flag States
Cup All-Star Race

.

Coverage

What NASCAR events does Sportradar cover, and to what depth?

Coverage information for the NASCAR API can be found here.

Integration

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120

The TTL may adjust when an event is live for some game-centric endpoints. This information is available for each endpoint on our developer portal.

Race Statuses

What are the valid `race` - `status` values?

scheduled – The race is scheduled to occur.
initialized – We are ready to begin recording actions against the scheduled race.
practice – We are currently in the practice round.
qualifying – We are currently in the qualifying round.
prerace – Prerace may occur before practice, qualifying, or warmup rounds.
inprogress – The race is in progress.
complete – The race is over, but stat validation is not complete.
closed – The race is over and the statistics have been validated.
delayed – The race has been delayed.
canceled – The race has been canceled. No makeup race will be played as a result.
rescheduled – The race has been postponed and will be rescheduled at a later date.
maintenance – The closed race has been reopened to correct one or more statistics. We would recommend against pulling data for a race while in this status.
warmup – The scheduled race is set to take place and will begin soon.
time-tbd - The race time is yet to be determined.

What are the valid `practice` - `status` values?

scheduled – The race is scheduled to occur.
inprogress – The race is in progress.
delayed – The race has been delayed.
postponed - The race has been postponed.
canceled – The race has been canceled.
complete – The race is over, we are in the process of validating the race statistics.
time-tbd - The race time is yet to be determined.

What are the valid `qualifying` - `status` values?

no-qualifying - There is no qualifying race.
scheduled – The race is scheduled to occur.
inprogress – The race is in progress.
delayed – The race has been delayed.
postponed - The race has been postponed.
canceled – The race has been canceled.
complete – The race is over, we are in the process of validating the race statistics.
time-tbd - The race time is yet to be determined.

What happens if a race is postponed to another day?

Prior to race start:

If a race is postponed prior to the start, the IDs assigned to the race will remain unchanged. The race will resume from where it was left off once a new date and time are established. As soon as these details are confirmed, the race scheduled attribute is updated to reflect the changes. The start_time attribute is adjusted post-race.

Example Race: 6d88e04f-3da2-473d-a44b-8a0b38fe32cd

After race start:

If a race is postponed after the start, the data transfers from green flag to red flag with a status of inprogress until NASCAR makes the decision to finish the race a different day and end track activities. At this point, the status updates from inprogress to delayed, with the scheduled time remaining. The IDs assigned to the race will remain unchanged.

When the race finishes the following day the start_time and end_time values are adjusted to be the tv window for the rest of the race.

Example Race: 4daedbcd-f1c6-4bc1-9690-f85d1fd1af4a

Driver Statuses

What are the valid `driver` - `status` values?

ACT - Active
RET – Retired

What are the possible driver statuses for the `practice` - `status`, `qualifying` - `status`, and race `result` - `status`?

We have 2 different sets of driver statuses: statuses that are used during the session and statuses used post session.

Here are the live race driver statuses and their descriptions:

ontrack – The driver is currently active in the session.
accident – The driver is currently off the track, or ended his/her session due to an accident.

Here are the post race driver statuses and their descriptions:

garage – The driver ended the session in the garage for an unknown reason.
running – The driver ended the session running.
engine – The driver ended the session due to engine issues.
vibration – The driver ended the session due to vibration issues.
brakes – The driver ended the session due to a brake issue.
fuelpump – The driver ended the session due to issue with the fuel pump.
spindle – The driver ended the session due to an issues with the spindle.
transmission – The driver ended the session due to a transmission issue.
handling – The driver ended the session due to handling issues.
ignition – The driver ended the session due to an ignition issue.
oilleak – The driver ended the session due to an oil leak.
overheating – The driver ended the session due to an overheating issue.
electrical – The driver ended the session due to an electrical issue.
axle – The driver ended the session due to an issue with an axle.
clutch – The driver ended the session due to an issue with the clutch.
suspension - The driver ended the session due to suspension issues.
reargear – The driver ended the session due to rear gear issues.
dnq – The driver did not qualify for the race.
withdrew – The driver has withdrawn.
disqualified – The driver has been disqualified.
dvp - The driver ended the session due to the Damaged Vehicle Policy.
alternator - The driver ended the session due to an issue with an alternator.
tooslow - The driver ended the session due to not making minimal speed.

Race Conditions

What are the valid race conditions?

normal – The race is under normal racing conditions.
accident_caution – The race is under caution due to an accident.
conditions_caution – The race is under caution due to track conditions.
weather_caution – The race is under caution due to weather conditions.
accident_suspended – The race has been suspended due to an accident.
conditions_suspended – The race has been suspended due to track conditions.
weather_suspended – The race has been suspended due to weather conditions
accident_shortened – The race has been shortened due to an accident.
conditions_shortened – The race has been shortened due to track conditions.
weather_shortened –The race has been shortened due to weather conditions.
pitstops – The race is in progress, but all cars are in the pits.

Flag States

What are the valid flag states?

warmup
green
yellow
red
finish

Heat Races

How does Sportradar handle Heat Races and Dirt Track Races?

Heat Races behave like the Duel Races at Daytona. Each Heat Race has its own Race ID under the appropriate Event ID. These will be short distance races that last under 15 minutes.

If a heat race cancels due to weather, the status of the race will move to canceled. Once a heat race is over, the starting grid for the main race updates.

<event id="8493136c-8b19-4cf0-a93d-45bf8eb88990" name="NASCAR Cup Series at LA Coliseum" start_date="2023-02-05">
    <track name="Los Angeles Memorial Coliseum " market="Los Angeles" completed="1923" distance="0.25" shape="Oval" address="3911 Figueroa Street" city="Los Angeles" state="CA" zip="90037" country="USA" id="fdb41823-ab72-4dba-951f-19ec2529d5e4"/>
    <race id="b257fa1f-a1d8-4ba1-917b-e04d2281cafb" name="Busch Light Clash at The Coliseum Heat Race 1" status="closed" distance="6" laps="25" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-05T22:00:00+00:00" start_time="2023-02-05T22:00:00+00:00" end_time="2023-02-05T22:15:00+00:00">
        <broadcast satellite="9"/>
    </race>
    <race id="5b2e8c02-371e-486a-9731-1c5ba39854be" name="Busch Light Clash at The Coliseum Heat Race 2" status="closed" distance="6" laps="25" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-05T22:15:00+00:00" start_time="2023-02-05T22:15:00+00:00" end_time="2023-02-05T22:30:00+00:00">
        <broadcast satellite="9"/>
    </race>
    <race id="d64840c7-8daf-4339-a242-4b5a69c0a4ab" name="Busch Light Clash at The Coliseum Heat Race 3" status="closed" distance="6" laps="25" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-05T22:30:00+00:00" start_time="2023-02-05T22:30:00+00:00" end_time="2023-02-05T22:50:00+00:00">
        <broadcast satellite="9"/>
    </race>
    <race id="f2398b28-d4dd-4ae5-bbb5-07463265bf6a" name="Busch Light Clash at The Coliseum Heat Race 4" status="closed" distance="6" laps="25" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-05T22:45:00+00:00" start_time="2023-02-05T22:45:00+00:00" end_time="2023-02-05T23:02:00+00:00">
        <broadcast satellite="9"/>
    </race>
    <race id="c8f51ff3-f56b-4249-ad8f-a3e8cc7961c1" name="Busch Light Clash at The Coliseum Last Chance Qualifying Race #1" status="closed" distance="12" laps="50" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-05T23:10:00+00:00" start_time="2023-02-05T23:10:00+00:00" end_time="2023-02-05T23:23:00+00:00">
        <broadcast satellite="9"/>
    </race>
    <race id="c337ea4b-8a79-4634-a4eb-c9b0a30d135c" name="Busch Light Clash at The Coliseum Last Chance Qualifying Race #2" status="closed" distance="12" laps="50" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-05T23:35:00+00:00" start_time="2023-02-05T23:35:00+00:00" end_time="2023-02-05T23:42:00+00:00">
        <broadcast satellite="9"/>
    </race>
    <race id="14acfaa3-22aa-488f-903f-d8c2b1349343" name="Busch Light Clash at The Coliseum" status="closed" distance="37" laps="150" chase_race="false" award_pole="false" stage_count="0" scheduled="2023-02-06T01:00:00+00:00" start_time="2023-02-06T01:00:00+00:00" end_time="2023-02-06T03:00:00+00:00">
        <broadcast network="FOX" satellite="9" radio="MRN"/>
        <prior_winner first_name="Joey" last_name="Logano" full_name="Joey Logano" id="894b273e-ce7d-446c-9ab0-d9a474ce9d7f"/>
    </race>
</event>

<race xmlns="http://feed.elasticstats.com/schema/nascar/race-v3.0.xsd" id="b257fa1f-a1d8-4ba1-917b-e04d2281cafb" name="Busch Light Clash at The Coliseum Heat Race 1" status="closed" condition="normal" distance="6" laps="25" actual_distance="6.25" chase_race="false" award_pole="false" purse="0.0" restrictor_plate="false" avg_speed="63.16" victory_margin="0.652" elapsed_time="00:05:57" lead_changes="3" cautions="1" caution_laps="0" stage_count="0" scheduled="2023-02-05T22:00:00+00:00" start_time="2023-02-05T22:00:00+00:00" end_time="2023-02-05T22:15:00+00:00" laps_completed="25">
    <track name="Los Angeles Memorial Coliseum " distance="0.25" shape="Oval" id="fdb41823-ab72-4dba-951f-19ec2529d5e4"/>
    <comments>
        <![CDATA[]]>
  
    </comments>
    <flags>
        <flag sequence="1" lap="0" flag_state="warmup">
    </flag>
        <flag sequence="2" lap="0" flag_state="green">
    </flag>
        <flag sequence="3" lap="2" flag_state="yellow">
            <comments>
                <![CDATA[#21, 42 Incident Turn 1]]>
      
            </comments>
            <beneficiary>
                <![CDATA[     ]]>
      
            </beneficiary>
        </flag>
        <flag sequence="4" lap="2" flag_state="red">
    </flag>
        <flag sequence="5" lap="2" flag_state="green">
    </flag>
        <flag sequence="6" lap="24" flag_state="finish">
    </flag>
    </flags>
    <results>
        <result start_position="2" position="1" status="running" pit_stops="0" best_lap="22" best_lap_speed="66.999" best_lap_time="13.433" elapsed_time="353.14" fastest_laps="6" avg_position="1.769" avg_speed="63.714" last_lap_speed="66.573" last_lap_time="13.519" avg_restart_speed="41.7" points="0" bonus_points="0" penalty_points="0" laps_led="6" times_led="2" laps_completed="25">
            <car number="10" sponsors="Smithfield" crew_chief="Drew Blickensderfer" id="2e3b8a4c-5c1c-401d-98b2-7c92bcab23e5">
                <manufacturer id="12844047-ab59-43ca-ab6c-c10d54931715" name="Ford"/>
                <owner id="f605ad11-b0a3-423b-a1f0-220cfa224968" name="Tony Stewart"/>
                <team id="876a07ff-ff53-4f23-9528-6d9795270244" name="Stewart Haas Racing">
                    <owner id="160c7b9e-b198-4b4d-9000-bcdc1a094cee" name="Tony Stewart"/>
                </team>
            </car>
            <driver first_name="Aric" last_name="Almirola" full_name="Aric Almirola" points_eligible="true" in_chase="false" id="e128a081-a2e8-4809-8038-8c936049bf7c"/>
            <laps-led>
                <lead sequence="1" start_lap="1" end_lap="1"/>
                <lead sequence="2" start_lap="20" end_lap="26"/>
            </laps-led>
        </result>
        <result start_position="3" position="2" status="running" pit_stops="0" best_lap="16" best_lap_speed="67.365" best_lap_time="13.36" elapsed_time="353.792" fastest_laps="7" avg_position="2.846" avg_speed="63.597" last_lap_speed="66.377" last_lap_time="13.559" avg_restart_speed="41.055" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="48" sponsors="Ally Financial" crew_chief="Blake Harris" id="733d54fb-e4f5-4829-bc2a-94af6c9c6504">
                <manufacturer id="dbf04b7a-c4a2-4cff-9dd0-cf1977fc446e" name="Chevrolet"/>
                <owner id="492ef62b-a861-4672-9940-0ec3133e04f1" name="Jeff Gordon"/>
                <team id="8427da4c-9c88-4849-9242-0c184d5ed67c" name="Hendrick Motorsports">
                    <owner id="df3acab4-1712-44bb-b913-897b4e20fd50" name="Rick Hendrick"/>
                </team>
            </car>
            <driver first_name="Alex" last_name="Bowman" full_name="Alex Bowman" points_eligible="true" in_chase="false" id="3ebef96f-43b4-422a-9d0c-db0127b25384"/>
        </result>
        <result start_position="1" position="3" status="running" pit_stops="0" best_lap="24" best_lap_speed="66.583" best_lap_time="13.517" elapsed_time="354.732" fastest_laps="2" avg_position="1.538" avg_speed="63.428" last_lap_speed="66.041" last_lap_time="13.628" avg_restart_speed="42.118" points="0" bonus_points="0" penalty_points="0" laps_led="19" times_led="1" laps_completed="25">
            <car number="31" sponsors="LeafFilter Gutter Protection/Celsius/Cirkul" crew_chief="Trent Owens" id="c2351769-a323-4eba-8553-ff34d122ffae">
                <manufacturer id="dbf04b7a-c4a2-4cff-9dd0-cf1977fc446e" name="Chevrolet"/>
                <owner id="935f3f46-6819-46f2-a21c-fb08c2c297c3" name="Matt Kaulig"/>
                <team id="58ca0768-82c7-49ca-a358-773b245db83b" name="Kaulig Racing">
                    <owner id="d7d36ea8-f61a-4ee4-aa38-07635c4f14a3" name="Matt Kaulig"/>
                </team>
            </car>
            <driver first_name="Justin" last_name="Haley" full_name="Justin Haley" points_eligible="true" in_chase="false" id="6e3ed92a-ee25-4dea-b116-d493ebccba07"/>
            <laps-led>
                <lead sequence="1" start_lap="0" end_lap="0"/>
                <lead sequence="2" start_lap="2" end_lap="19"/>
            </laps-led>
        </result>
        <result start_position="6" position="4" status="running" pit_stops="0" best_lap="17" best_lap_speed="67.325" best_lap_time="13.368" elapsed_time="355.163" fastest_laps="2" avg_position="4.077" avg_speed="63.351" last_lap_speed="66.162" last_lap_time="13.603" avg_restart_speed="41.126" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="42" sponsors="Sunseeker Resort/Black Rifle Coffee" crew_chief="Luke Lambert" id="1dbd3173-2412-48e7-bf44-cca9a72fc127">
                <manufacturer id="dbf04b7a-c4a2-4cff-9dd0-cf1977fc446e" name="Chevrolet"/>
                <owner id="00ce3576-b3b6-47f5-af84-d3bbcca0435d" name="Mike Beam"/>
                <team id="ee6a924b-58f4-40ea-8514-610936e32e78" name="LEGACY Motor Club">
                    <owner id="23972c17-6476-4824-aeb2-43896e2082d9" name="Richard Petty"/>
                </team>
            </car>
            <driver first_name="Noah" last_name="Gragson" full_name="Noah Gragson" points_eligible="true" in_chase="false" id="abab879c-93b3-4476-95a0-47f60df1a0e4"/>
        </result>
        <result start_position="5" position="5" status="running" pit_stops="0" best_lap="17" best_lap_speed="66.79" best_lap_time="13.475" elapsed_time="355.474" fastest_laps="0" avg_position="5.154" avg_speed="63.296" last_lap_speed="66.543" last_lap_time="13.525" avg_restart_speed="40.582" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="22" sponsors="Shell Pennzoil/AAA/Autotrader" crew_chief="Paul Wolfe" id="23a4be38-3039-4757-94f5-b4e478e4d7f8">
                <manufacturer id="12844047-ab59-43ca-ab6c-c10d54931715" name="Ford"/>
                <owner id="03246399-5e63-4c21-9c5f-24074e3bf515" name="Walter Czarnecki"/>
                <team id="e337709c-9fb6-4275-ad89-d9c100e71a1d" name="Team Penske">
                    <owner id="57198af5-d912-4efc-9135-95fc6c0a3fc5" name="Roger Penske"/>
                </team>
            </car>
            <driver first_name="Joey" last_name="Logano" full_name="Joey Logano" points_eligible="true" in_chase="false" id="894b273e-ce7d-446c-9ab0-d9a474ce9d7f"/>
        </result>
        <result start_position="7" position="6" status="running" pit_stops="0" best_lap="17" best_lap_speed="66.835" best_lap_time="13.466" elapsed_time="356.106" fastest_laps="0" avg_position="6.423" avg_speed="63.183" last_lap_speed="65.213" last_lap_time="13.801" avg_restart_speed="40.341" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="34" sponsors="Love's Travel Stops/Fr8 Auctions/Horizon Hobby/Chicago Pneumatic/Quincy Compressor" crew_chief="Travis Peterson" id="89e035f0-87f6-4835-ac58-8b7da32de4a4">
                <manufacturer id="12844047-ab59-43ca-ab6c-c10d54931715" name="Ford"/>
                <owner id="c81a723c-a430-4be5-969f-5fbf21c1d519" name="Bob Jenkins"/>
                <team id="bd38dfec-bb97-4f29-b032-cc6f0c77dfe6" name="Front Row Motorsports">
        </team>
            </car>
            <driver first_name="Michael" last_name="McDowell" full_name="Michael McDowell" points_eligible="true" in_chase="false" id="96fdd8d7-3776-42b8-baf2-6b4e2cf2d83d"/>
        </result>
        <result start_position="4" position="7" status="running" pit_stops="0" best_lap="18" best_lap_speed="67.325" best_lap_time="13.368" elapsed_time="356.584" fastest_laps="3" avg_position="7.154" avg_speed="63.099" last_lap_speed="65.284" last_lap_time="13.786" avg_restart_speed="40.542" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="21" sponsors="Motorcraft/Quick Lane" crew_chief="Brian Wilson" id="df4ce303-5e1b-4f90-bdd0-1e768780109c">
                <manufacturer id="12844047-ab59-43ca-ab6c-c10d54931715" name="Ford"/>
                <owner id="90731d44-8da2-45bd-a8a7-41107fc46e03" name="Glen Wood"/>
                <team id="0dd8fd36-8bb1-4930-bfdc-d0c6be3b1a13" name="Wood Brothers">
                    <owner id="9fe6c239-ccda-43d0-9bb3-7c72606bf210" name="Wood Brothers"/>
                </team>
            </car>
            <driver first_name="Harrison" last_name="Burton" full_name="Harrison Burton" points_eligible="true" in_chase="false" id="198c8de5-9175-4c42-acad-a1d8de6df398"/>
        </result>
        <result start_position="9" position="8" status="running" pit_stops="0" best_lap="23" best_lap_speed="67.054" best_lap_time="13.422" elapsed_time="357.508" fastest_laps="2" avg_position="8.269" avg_speed="62.936" last_lap_speed="65.891" last_lap_time="13.659" avg_restart_speed="39.775" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="77" sponsors="Ferris Mowers/NASCAR Fan Rewards" crew_chief="Kevin Bellicourt" id="5d9986fb-1155-4456-a38c-d56b4a618c34">
                <manufacturer id="dbf04b7a-c4a2-4cff-9dd0-cf1977fc446e" name="Chevrolet"/>
                <owner id="e611fa59-af3f-40b8-bd07-935eb5b26b01" name="Jeff Dickerson"/>
                <team id="9f742920-6e44-4581-8a61-e8c38cf21da4" name="Spire Motorsports">
        </team>
            </car>
            <driver first_name="Ty" last_name="Dillon" full_name="Ty Dillon" points_eligible="true" in_chase="false" id="bfcb8d32-fab0-4bfa-be14-cf9466e1d886"/>
        </result>
        <result start_position="8" position="9" status="running" pit_stops="0" best_lap="21" best_lap_speed="66.637" best_lap_time="13.506" elapsed_time="359.475" fastest_laps="2" avg_position="7.769" avg_speed="62.591" last_lap_speed="66.167" last_lap_time="13.602" avg_restart_speed="40.823" points="0" bonus_points="0" penalty_points="0" laps_led="0" times_led="0" laps_completed="25">
            <car number="17" sponsors="Fastenal/Fifth Third Bank/Violet Defense/Esperion Therapeutics/Pala Casino/Castrol" crew_chief="Scott Graves" id="a7fc0b6d-da2f-4cb6-9f7d-154e5351d788">
                <manufacturer id="12844047-ab59-43ca-ab6c-c10d54931715" name="Ford"/>
                <owner id="4788307e-e269-4409-8fae-bbda98214196" name="Jack Roush"/>
                <team id="69cd5f7e-cb9d-46c0-a2c3-c1dde01969ee" name="Roush Fenway Keselowski Racing">
        </team>
            </car>
            <driver first_name="Chris" last_name="Buescher" full_name="Chris Buescher" points_eligible="true" in_chase="false" id="25cfebb6-24e5-429c-a9db-c276bab0e228"/>
        </result>
    </results>
</race>
<!-- Generation ended @ 2023-03-14 22:18:43 UTC -->

Cup All-Star Race

Why is the Qualifying Leaderboard empty for the Cup All-Star Race?

The Qualifying Leaderboard is empty for the Cup All-Star Race in Charlotte, as qualifying is handled differently at that track.

The starting grid is finalized 15 minutes before the scheduled race start and will be available in the Starting Grid endpoint.