Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

NASCAR Change Log

Find all updates to the NASCAR v3 API and its documentation

Laps Completed

Release DateFeeds
Affected
Benefit
1/2/2024Race LeaderboardLaps completed (result.laps_completed) will now update live during a race for all drivers.

Seasons Endpoint

Release DateFeeds
Affected
Benefit
1/2/2024SeasonsAdded a Seasons endpoint which returns a list of all available seasons within each race series.

Use this endpoint to have a clear indication of the current season, and to obtain ids for past seasons.
[
    {
        "id": "32252f5c-ca88-460f-b786-2d28503e6048",
        "alias": "TRUCK",
        "name": "NASCAR Craftsman Truck Series",
        "seasons": [
            {
                "id": "bdafc761-d7b8-42cb-bc38-6309422ae606",
                "year": 2012,
                "start_date": "2012-02-24",
                "end_date": "2012-11-16",
                "status": "closed"
            },
            {
                "id": "da5989ef-c99b-4d74-9d00-52fed703b58e",
                "year": 2013,
                "start_date": "2013-02-22",
                "end_date": "2013-11-15",
                "status": "closed"
            },
            {
                "id": "646760dc-da78-45d5-ba6c-318697444845",
                "year": 2014,
                "start_date": "2014-02-21",
                "end_date": "2014-11-14",
                "status": "closed"
            },
            {
                "id": "23636ac9-1127-4849-9032-c589618dd5f8",
                "year": 2015,
                "start_date": "2015-02-20",
                "end_date": "2015-11-20",
                "status": "closed"
            },
            {
                "id": "69a8e978-bdb6-44c8-b0ab-efa749b7d39e",
                "year": 2016,
                "start_date": "2016-02-19",
                "end_date": "2016-11-18",
                "status": "closed"
            },
            {
                "id": "281f71d2-c276-4d60-9633-9fa1160ccc12",
                "year": 2017,
                "start_date": "2017-02-24",
                "end_date": "2017-11-17",
                "status": "closed"
            },
            {
                "id": "4d6b14f0-929e-422d-98c8-f30fce4be88e",
                "year": 2018,
                "start_date": "2018-02-16",
                "end_date": "2018-11-16",
                "status": "closed"
            },
            {
                "id": "10bc1545-bc9a-46d0-a1e1-8dafdac75f01",
                "year": 2019,
                "start_date": "2019-02-15",
                "end_date": "2019-11-15",
                "status": "closed"
            },
            {
                "id": "8d71550e-0619-4c73-88ae-fb1cc3d77c49",
                "year": 2020,
                "start_date": "2020-02-14",
                "end_date": "2020-11-06",
                "status": "closed"
            },
            {
                "id": "c3e8bc93-39e0-4ac9-9452-77cb75745619",
                "year": 2021,
                "start_date": "2021-02-12",
                "end_date": "2021-11-05",
                "status": "closed"
            },
            {
                "id": "62e03c2a-8f12-4fd9-a6ed-79ce1dea291d",
                "year": 2022,
                "start_date": "2022-02-18",
                "end_date": "2022-11-04",
                "status": "closed"
            },
            {
                "id": "3b9423bd-11b3-4694-a52b-35e1780407a7",
                "year": 2023,
                "start_date": "2023-02-17",
                "end_date": "2023-11-03",
                "status": "closed"
            },
            {
                "id": "d443a1f3-2e24-4b46-8344-2f71090a39ae",
                "year": 2024,
                "start_date": "2024-02-16",
                "end_date": "2024-11-08",
                "status": "scheduled"
            }
        ]
    },
    {
        "id": "3e32047e-4ff3-4e35-a607-1546a2c32214",
        "alias": "CUP",
        "name": "NASCAR Cup Series",
        "seasons": [
            {
                "id": "06753868-606b-4842-8b6a-751ecfd241ba",
                "year": 2012,
                "start_date": "2012-02-18",
                "end_date": "2012-11-11",
                "status": "closed"
            },
            {
                "id": "908399c9-c23d-4e14-acad-52eacf7a96a1",
                "year": 2013,
                "start_date": "2013-02-16",
                "end_date": "2013-11-17",
                "status": "closed"
            },
            {
                "id": "9d6ad282-94e7-44a2-9c9c-305e5e26bf26",
                "year": 2014,
                "start_date": "2014-02-15",
                "end_date": "2014-11-16",
                "status": "closed"
            },
            {
                "id": "97afb0da-e49b-4359-bf91-ce54dbf51597",
                "year": 2015,
                "start_date": "2015-02-14",
                "end_date": "2015-11-22",
                "status": "closed"
            },
            {
                "id": "14ef42df-dbfc-4abb-b808-1e4646bf8bd9",
                "year": 2016,
                "start_date": "2016-02-13",
                "end_date": "2016-11-20",
                "status": "closed"
            },
            {
                "id": "785904a5-0729-4e62-9e1b-42a315e2b575",
                "year": 2017,
                "start_date": "2017-02-19",
                "end_date": "2017-11-19",
                "status": "closed"
            },
            {
                "id": "1a9a2cec-0d17-4fe5-acdd-19df5d5d16cc",
                "year": 2018,
                "start_date": "2018-02-11",
                "end_date": "2018-11-18",
                "status": "closed"
            },
            {
                "id": "d39477c5-3c73-4119-98f1-5b88958b524a",
                "year": 2019,
                "start_date": "2019-02-10",
                "end_date": "2019-11-17",
                "status": "closed"
            },
            {
                "id": "75ef9d66-27db-460e-83dd-0d4858447dbd",
                "year": 2020,
                "start_date": "2020-02-09",
                "end_date": "2020-11-08",
                "status": "closed"
            },
            {
                "id": "5886359d-16f1-4a45-a794-6783274b4983",
                "year": 2021,
                "start_date": "2021-02-09",
                "end_date": "2021-11-07",
                "status": "closed"
            },
            {
                "id": "81d2010a-8a5d-4e69-b2ec-cc21c3f988ce",
                "year": 2022,
                "start_date": "2022-02-06",
                "end_date": "2022-11-06",
                "status": "closed"
            },
            {
                "id": "c0d60291-2ccc-44c6-9d81-039b01f41110",
                "year": 2023,
                "start_date": "2023-02-05",
                "end_date": "2023-11-05",
                "status": "closed"
            },
            {
                "id": "94f61566-720e-4d2f-b4a4-7de9fc9cd257",
                "year": 2024,
                "start_date": "2024-02-04",
                "end_date": "2024-11-10",
                "status": "scheduled"
            }
        ]
    },
    {
        "id": "a3983c10-f014-4a80-85bc-b0dffaa74b69",
        "alias": "eNASCAR",
        "name": "eNASCAR iRacing Pro Invitational Series",
        "seasons": [
            {
                "id": "1ca4689a-f3f9-4051-bab8-aecd044f6dec",
                "year": 2020,
                "start_date": "2020-03-22",
                "end_date": "2020-05-09",
                "status": "closed"
            }
        ]
    },
    {
        "id": "e745d98a-83b1-4f3f-b9e3-23052486c6b2",
        "alias": "XFINITY",
        "name": "NASCAR Xfinity Series",
        "seasons": [
            {
                "id": "1670c9f1-bce5-4bf8-9b71-46734437d578",
                "year": 2012,
                "start_date": "2012-02-25",
                "end_date": "2012-11-17",
                "status": "closed"
            },
            {
                "id": "8fc2f77f-a8fd-426b-a56c-9a3167d3dc76",
                "year": 2013,
                "start_date": "2013-02-23",
                "end_date": "2013-11-16",
                "status": "closed"
            },
            {
                "id": "5f9d616e-561b-4159-8aa6-eee6c36c08ce",
                "year": 2014,
                "start_date": "2014-02-22",
                "end_date": "2014-11-15",
                "status": "closed"
            },
            {
                "id": "1ca071b4-9f7f-4bf6-8e41-06e6cb87d053",
                "year": 2015,
                "start_date": "2015-02-21",
                "end_date": "2015-11-21",
                "status": "closed"
            },
            {
                "id": "56fbc6ab-e264-42a7-a0e2-f5ffe264ef73",
                "year": 2016,
                "start_date": "2016-02-20",
                "end_date": "2016-11-19",
                "status": "closed"
            },
            {
                "id": "fd3c6b32-f2dc-40e3-ab80-24d0fece345e",
                "year": 2017,
                "start_date": "2017-02-25",
                "end_date": "2017-11-18",
                "status": "closed"
            },
            {
                "id": "c0b44cb9-7a63-4d4b-9684-c37493c10295",
                "year": 2018,
                "start_date": "2018-02-17",
                "end_date": "2018-11-17",
                "status": "closed"
            },
            {
                "id": "08b50957-b7a1-4dad-91bc-2c9d654015ea",
                "year": 2019,
                "start_date": "2019-02-16",
                "end_date": "2019-11-16",
                "status": "closed"
            },
            {
                "id": "78187bc1-9f96-4013-994e-f68d06797d05",
                "year": 2020,
                "start_date": "2020-02-15",
                "end_date": "2020-11-07",
                "status": "closed"
            },
            {
                "id": "c9a4b324-5b8a-48c2-b6a1-25514e372142",
                "year": 2021,
                "start_date": "2021-02-13",
                "end_date": "2021-11-06",
                "status": "closed"
            },
            {
                "id": "40d04e44-e470-40c1-b23e-ddab4e629c96",
                "year": 2022,
                "start_date": "2022-02-19",
                "end_date": "2022-11-05",
                "status": "closed"
            },
            {
                "id": "243cc143-6029-4f64-9871-157d7b66f5f0",
                "year": 2023,
                "start_date": "2023-02-18",
                "end_date": "2023-11-04",
                "status": "closed"
            },
            {
                "id": "e969ab60-7194-446a-8726-8ce239d2299b",
                "year": 2024,
                "start_date": "2024-02-17",
                "end_date": "2024-11-09",
                "status": "scheduled"
            }
        ]
    }
]

Heat Races

Release DateFeeds
Affected
Benefit
1/2/2024Entry List

Playoff Schedule

Practice Leaderboard

Qualifying Leaderboard

Race Leaderboard

Schedule

Starting Grid
Added a boolean value to signify whether a race is a Heat Race.

Parent Id

Release DateFeeds
Affected
Benefit
12/21/2023Entry List

Playoff Schedule

Practice Leaderboard

Qualifying Leaderboard

Race Leaderboard

Schedule

Starting Grid
Added a parent_id to races, allowing you to more easily group race events together across seasons.
"races": [   
    {
        "id": "49e2b4df-e9e3-4385-8f93-d4bf148097bf",
        "name": "Coke Zero Sugar 400",
        "status": "closed",
        "number": 26,
        "distance": 400,
        "laps": 160,
        "chase_race": false,
        "award_pole": true,
        "stage_count": 2,
        "stage_1_laps": 35,
        "stage_2_laps": 60,
        "stage_3_laps": 65,
        "parent_id": "d639f7b4-861c-4957-aadf-db20fb5834f0",
        "scheduled": "2023-08-26T23:00:00+00:00",
        "start_time": "2023-08-26T23:00:00+00:00",
        "end_time": "2023-08-26T23:00:00+00:00",
        "broadcast":
        {
            "network": "NBC",
            "radio": "MRN"
        },
        "prior_winner":
        {
            "first_name": "Austin",
            "last_name": "Dillon",
            "full_name": "Austin Dillon",
            "id": "8853e676-384e-4d08-8808-970fd111f36a"
        }
    }
]

Latitude & Longitude

Release DateFeeds
Affected
Benefit
12/21/2023Entry List

Playoff Schedule

Practice Leaderboard

Qualifying Leaderboard

Race Leaderboard

Schedule

Starting Grid

Tracks
Added latitude and longitude for all tracks.
<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" 
lng="-118.282842" lat="34.0133448"/> 
"events": [
    {
        "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",
            "lat": "34.0133448",
            "lng": "-118.282842"
        },

Driver Statuses

Release DateFeeds AffectedUpdate
02/22/2022Practice Leaderboard
Race Leaderboard
Added three new post race driver statuses: dvp, alternator, and tooslow

Upgraded Coverage

Release DateFeeds AffectedUpdate
02/01/2022Race Leaderboard
Schedule
Enhanced our coverage of NASCAR Heat Races. Each Heat Race will now have its own unique Race ID.

Heat Race Processing

Release DateFeeds AffectedBenefit
01/12/2022Schedule
Race Leaderboard
Starting Grid
Added an FAQ entry detailing a new process for handling Heat Races.

Series & Data Updates

Release DateFeeds AffectedBenefit
01/04/2022All feedsUpdated the NASCAR series colors.

Updated the Sponsor character limit in the NASCAR feed.

New feature to include margin of victory for the NASCAR weekend feed.

Award Pole Attribute

Release DateFeeds AffectedBenefit
04/13/2020Entry List
Playoff Schedule
Practice Leaderboard
Qualifying Leaderboard
Race Leaderboard
Schedule
Starting Grid
Added award_pole to the race information.

Removed Passing Stats

Release DateFeeds AffectedBenefit
01/14/2020Race LeaderboardRemoved passing data, as it is no longer supported by NASCAR: times_passed, quality_passes, passes_made, and passing_differential.

Driver Statuses

Release DateFeeds AffectedBenefit
01/14/2020Practice Leaderboard
Race Leaderboard
Added additional driver statuses: disqualified and off.

Laps Per Race Stage

Release DateFeeds AffectedBenefit
01/14/2020Race Leaderboard
Schedule
Added number of laps per race stage: stage_1_laps, stage_2_laps, and stage_3_laps.

Broadcast Info for Practice

Release DateFeeds AffectedBenefit
01/14/2020Practice LeaderboardAdded broadcast information for practice: cable, internet, network, radio, and satellite.

Broadcast Info for Qualifying

Release DateFeeds AffectedBenefit
01/14/2020Qualifying LeaderboardAdded broadcast information for qualifying: cable, internet, network, radio, and satellite.

'Playoff Schedule' Endpoint

Release DateFeeds AffectedBenefit
01/30/2019Playoff ScheduleData points added to support the new Playoff Schedule feed.

Practice Status

Release DateFeeds AffectedBenefit
01/30/2019Practice LeaderboardAdded practice status to the feed.

Qualifying Status

Release DateFeeds AffectedBenefit
01/30/2019Qualifying LeaderboardAdded qualifying status to the feed.

Prior Winner Data

Release DateFeeds AffectedBenefit
01/30/2019ScheduleAdded prior winner data points to the Schedule feed, including: first_name, last_name, full_name, and id.

Chase Wins

Release DateFeeds AffectedBenefit
01/30/2019Driver Standings
Rookie Standings
Added chase_wins and chase_stage_wins data points.

Playoff Round Stats

Release DateFeeds AffectedBenefit
01/30/2019Playoff ScheduleAdded the following data points for playoff round: driver_limit, id, name, and status. Event, seasons, and series data points added to the new Playoff Schedule feed.

Stage Leaderboard Stats

Release DateFeeds AffectedBenefit
05/22/2017Race LeaderboardAdded data points for stage_3_points, stage_3_wins, and stage_count.

Lap Speed Stats

Release DateFeeds AffectedBenefit
02/22/2017Race LeaderboardAdded data points for avg_restart_speed, last_lap_speed, and last_lap_time to the results element.

Pit Stop Stats

Release DateFeeds AffectedBenefit
02/22/2017Race LeaderboardAdded data points for in_time and out_time to the pit_stops element.

Chase Bonus & Stage Wins

Release DateFeeds AffectedBenefit
02/15/2017Driver Standings
Owner Standings
Manufacturer Standings
Added Chase Bonus and Stage Wins to drivers, rookies, and owners Standings.

Stage 1 & 2 Points and Wins

Release DateFeeds AffectedBenefit
02/15/2017Race LeaderboardAdded stage 1 and 2 points and wins to Race Leaderboards.

Lap Statistics

Release DateFeeds AffectedBenefit
08/24/2016Race LeaderboardAdded behind leader, best lap, best lap speed, and best lap time to the feed.

Qualifying Start & End Times

Release DateFeeds AffectedBenefit
08/24/2016Qualifying LeaderboardAdded qualifying start and end time to the feed.

Practice Start & End Times

Release DateFeeds AffectedBenefit
08/24/2016Practice LeaderboardAdded practice start and end time to the feed.

Driver Bio Info

Release DateFeeds AffectedBenefit
02/04/2015DriversAdded children, hobbies, and twitter handle to the feed.

Distance & Laps

Release DateFeeds AffectedBenefit
02/04/2015Entry List
Qualifying Leaderboard
Starting Grid
Added distance and laps to the feeds

Pit Stops

Release DateFeeds AffectedBenefit
02/04/2015Race LeaderboardPit Stops added to the feed.

Venue Data Updates

Release DateFeeds AffectedBenefit
02/04/2015Schedule
Tracks
Added owner, surface, and type to venue information

New Endpoints

Release DateFeeds AffectedBenefit
02/04/2015Driver Statistics
Entry List
Practice Leaderboard
Qualifying Leaderboard
Race Leaderboard
Starting Grid
NASCAR official versions of these feeds added to our offering to go along with our standard Sportradar NASCAR feeds.

Qualifying Round Info

Release DateFeeds AffectedBenefit
01/08/2015Qualifying LeaderboardAdded round information (round, lap time, position, and speed)

JSON Compatibility

Release DateFeeds AffectedBenefit
01/08/2015AllJSON version of each feed

XSL Transformations

Release DateFeeds AffectedBenefit
01/08/2015AllAdded XSL transformation for clarity, when feeds are viewed via a browser.