Docs
v3
Coverage MatrixDocumentationChange LogLog InContact Us
Docs
Coverage MatrixDocumentationChange LogLog InContact Us

NASCAR FAQs

Frequently asked questions for NACAR v3

Click on the categories below or browse questions on the right panel.

Categories

.

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?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601


What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601


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.

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.
  • garage – The driver is currently in the garage.
  • accident – The driver is currently off the track, or ended his/her session due to an accident.
  • off – The driver has gone off track.

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.



🙋

More questions?

Reach out to [email protected] for further assistance.

© Sportradar AG, St. Gallen, Switzerland