NASCAR v3

Frequently Asked Questions
Quick Access
Postman Collection XSD Schema
Download
## NASCAR API Overview Sportradar is the official data provider of real-time NASCAR data! We combine on-track speed and accuracy with in-depth race and seasonal driver statistics. All three NASCAR series (Cup, Xfinity, and Trucks) are covered in full. The NASCAR API is consistent in structure, format, and behavior with our other League Specific APIs. Our primary feeds return schedules, standings, team and driver data, and real-time race leaderboards. Our other feeds provide a host of complimentary statistics and information, including:
  • Entry lists
  • Practice leaderboards
  • Qualifying leaderboards
  • Seasonal driver statistics
  • Detailed track profiles
API API Version Data Entry Workflow
NASCAR v3 Data Entry Workflow
Note: Authentication is required for all API calls.
## NASCAR v3 API Map To best utilize the NASCAR API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Example:

>To find the leaderboard for a given race: >
  1. Call the Schedule endpoint and find the Race Id for your desired race
  2. Call the Race Leaderboard using the Race Id
>The leaderboard for this race is displayed. The primary Schedule feeds require only a Series Id (e.g. 'mc' for Monster Cup) to call the endpoint. These feeds provide season Race Ids, which can be used to generate each of the Event feeds. ## Daily Change Log Provides IDs and timestamps for race information, race results, driver information, track information, or standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/2014/02/23/changes.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/2014/02/23/changes.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/2014/02/23/changes.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Daily Change Log feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{year}`/`{month}`/`{day}`/changes.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | year | Year in 4 digit format (YYYY). | | month | Month in 2 digit format (MM). | | day | Day in 2 digit format (DD). | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Change Log, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/changelog-v2.0.xsd?api_key=`{your_api_key}` Return to top ## Driver, Rookie, Owner, and Manufacturer Standings Provides detailed standings info for Driver, Rookie, Owner, Manufacturer. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/2014/standings/drivers.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/2014/standings/drivers.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/2014/standings/drivers.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this for drivers, rookies, owners, or manufacturers. Access the Driver, Rookie, Owner, and Manufacturer Standings feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/`{year}`/standings/`{standings_type}`.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), Monster Energy Cup (mc), or eNASCAR (enas) [Note: eNASCAR series is only supported for the 2020 season]. | | year | Year in 4 digit format (YYYY). | | standings_type | Type of standing: drivers, rookies, owners, or manufacturers. | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Driver, Rookie, Owner, and Manufacturer Standings, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/standings-v2.0.xsd?api_key=`{your_api_key}` Return to top ## Driver Statistics Provides seasonal statistics for all drivers, catalogued by track type, track name, and race name. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/drivers/2014/drivers.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/drivers/2014/drivers.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/drivers/2014/drivers.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Driver Statistics feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/drivers/`{year}`/drivers.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), or Monster Energy Cup (mc). | | year | Year in 4 digit format (YYYY). | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Driver Statistics, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/statistics-v3.0.xsd?api_key=`{your_api_key}` Return to top ## Drivers Provides detailed driver biographical information for a given season, including information regarding their cars and teams. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/2014/drivers/list.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/2014/drivers/list.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/2014/drivers/list.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Drivers feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/`{year}`/drivers/list.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), Monster Energy Cup (mc), or eNASCAR (enas) [Note: eNASCAR series is only supported for the 2020 season]. | | year | Year in 4 digit format (YYYY). | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Drivers list, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/series-v2.0.xsd?api_key=`{your_api_key}` Return to top ## Entry List Provides information regarding all drivers scheduled to attempt to qualify for a race. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/entry_list.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/entry_list.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/entry_list.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Entry List feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/races/`{race_id}`/entry_list.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), Monster Energy Cup (mc), or eNASCAR (enas) [Note: eNASCAR series is only supported for the 2020 season]. | | race_id | ID for the given race. | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Entry List, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/race-v3.0.xsd?api_key=`{your_api_key}` Return to top ## Playoff Schedule Provides detailed schedule info for all playoff events associated with a given series. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/mc/2018/playoff/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/mc/2018/playoff/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/mc/2018/playoff/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Playoff Schedule feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/`{year}`/playoff/schedule.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), or Monster Energy Cup (mc). | | year | Year in 4 digit format (YYYY). | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Playoff Schedule, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}` Return to top ## Practice Leaderboard Provides practice information for all drivers entered in the field including sequence, speed, time, and finish position. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/practices.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/practices.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/practices.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Practice Leaderboard feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/races/`{race_id}`/practices.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), or Monster Energy Cup (mc). | | race_id | ID for the given race. | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Practice Leaderboard, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/race-v3.0.xsd?api_key=`{your_api_key}` Return to top ## Qualifying Leaderboard Provides qualifying information for all drivers entered in the field including fastest speed, time, and finish position. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/qualifying.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/qualifying.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/qualifying.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Qualifying Leaderboard feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/races/`{race_id}`/qualifying.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), or Monster Energy Cup (mc). | | race_id | ID for the given race. | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Qualifying Leaderboard, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/race-v3.0.xsd?api_key=`{your_api_key}` Return to top ## Race Leaderboard Provides detailed information concerning a drivers race performance during and after the race. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/results.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. > eNASCAR returns xml structured like this. Access the Race Leaderboard feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/races/`{race_id}`/results.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), Monster Energy Cup (mc), or eNASCAR (enas) [Note: eNASCAR series is only supported for the 2020 season]. | | race_id | ID for the given race. | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Race Leaderboard, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/race-v3.0.xsd?api_key=`{your_api_key}` Return to top ## Schedule Provides detailed schedule info for all events in a given series. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/2014/races/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/2014/races/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/2014/races/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Schedule feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/`{year}`/races/schedule.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), Monster Energy Cup (mc), or eNASCAR (enas) [Note: eNASCAR series is only supported for the 2020 season]. | | year | Year in 4 digit format (YYYY). | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Schedule, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}` Return to top ## Starting Grid Provides the official start order of a race. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/starting_grid.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/starting_grid.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/sc/races/fef6db6c-a8e2-4f15-af8e-587d850824b3/starting_grid.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Starting Grid feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/`{nascar_series}`/races/`{race_id}`/starting_grid.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | nascar_series | Sprint Cup (sc), Xfinity (xf), Camping World (cw), Gander Outdoors (go), Monster Energy Cup (mc), or eNASCAR (enas) [Note: eNASCAR series is only supported for the 2020 season]. | | race_id | ID for the given race. | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Starting Grid, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/race-v3.0.xsd?api_key=`{your_api_key}` Return to top ## Tracks Provides detailed information regarding all tracks within the Cup, Xfinity, Camping World, and eNASCAR race series. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nascar-ot3/tracks/list.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nascar-ot3/tracks/list.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nascar-ot3/tracks/list.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Tracks feed by replacing the parameters in the following URL: https://api.sportradar.us/nascar-`{access_level}{version}`/tracks/list.`{format}`?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | access_level | Defines the access level of your API key as Production (o) or Trial (ot). | | version | Version number of the API you are accessing (Current Version: 3). | | format | xml or json. | | your_api_key | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tracks list, replace the parameters in the following URL. https://api.sportradar.us/nascar-`{access_level}{version}`/schema/track-v2.0.xsd?api_key=`{your_api_key}` Return to top ## Frequently Asked Questions

Q: What format are date fields presented in?

A: 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

Q: What format are the date/time fields presented in?

A: 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

Q: What are the "race - status" values I can expect to see in the feeds and their definitions?

A: Here are the race statuses and their descriptions:

  • 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.
  • warmup – The scheduled race is set to take place and will begin soon.

Q: What are the "practice - status" values I can expect to see in the feeds and their definitions?

A: Here are the practice statuses and their descriptions:

  • 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.

Q: What are the "qualifying - status" values I can expect to see in the feeds and their definitions?

A: Here are the qualifying statuses and their descriptions:

  • 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.

Q: What are the "driver - status" values I can expect to see in the feeds and their definitions?

A: Here are the driver statuses and their descriptions:

  • ACT - Active
  • RET – Retired

Q: What are the race conditions I can expect to see in the feeds and their definitions?

A: Here are the race conditions and their descriptions:

  • 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.

Q: What are the possible driver statuses for the "practice - status", "qualifying - status", and race "result - status" that I can expect and what are their definitions?

A: 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.
  • off – The driver has gone off track.
  • disqualified – The driver has been disqualified.

Q: What are the flag states I can expect to see in the feeds and their definitions?

A: Here are the flag states:

  • warmup
  • green
  • yellow
  • red
  • finish

Q: How does Sportradar handle Heat Races like the Exhibition Cup race in February and Dirt Track Races?

A: 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.

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

A: For the Cup All-Star Race in Charlotte, the qualifying feed will be empty, as qualifying is handled differently at that track. The starting grid will not be finalized until 15 minutes prior to the scheduled race start and will be available in the Starting Grid feed.

Q: What feeds are supported for the eNASCAR series?

A: The following feeds will be supported for the eNASCAR series (Note: eNASCAR series is only supported for the 2020 season):

  • Drivers
  • Tracks
  • Schedule
  • Entry List
  • Starting Grid
  • Race Leaderboard (Note: limited race statistics will be available, see below)
  • Driver Standings
  • Owner Standings
  • Manufacturer Standings
  • Daily Change Log

Q: What race statistics are supported for the eNASCAR series?

A: The following race statistics will be supported for the eNASCAR series (Note: eNASCAR series is only supported for the 2020 season):

  • Bonus Points
  • Laps Completed
  • Laps Led
  • Penalty Points
  • Points
  • Position
  • Result Status
  • Starting Position
  • Times Led
Return to top

Docs Navigation