Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Schedule

NASCAR Schedule provides detailed schedule info for all events in a given series.

⏱️

Update Frequency

2s Time To Live / Cache



Data Points

Series & Events:
AttributeParent ElementTypeDescription
idseries - seasonGUIDUnique ID of a season
ex. 81d2010a-8a5d-4e69-b2ec-cc21c3f988ce
yearseries - seasonStringYear of a season
aliasseriesStringAbbreviation for a NASCAR series
ex. CUP or TRUCK
idseriesGUIDUnique ID of a series
ex. 3e32047e-4ff3-4e35-a607-1546a2c32214
nameseriesStringName of a NASCAR series
ex. NASCAR Cup Series or NASCAR Camping World Truck Series
idseries - season - eventGUIDUnique ID of an event within a season
ex. daad37bb-f97f-4906-b3c3-96a05e211390
nameseries - season - eventStringName of an event within a season
ex. NASCAR Cup Series at Bristol
start_dateseries - season - eventDateStart date of an event within a season
ex. 2022-09-04
Race:

Attribute

Parent Element

Type

Description

start_time

event - race

dateTime

Original TV broadcast start time of a race
ex. 2022-09-04T22:00:00+00:00

end_time

event - race

dateTime

Original TV broadcast end time of a race
ex. 2022-09-05T02:00:00+00:00

award_pole

event - race

Boolean

Signifies a race provides a pole award for the first driver

chase_race

event - race

Boolean

Signifies a race is part of the playoffs

distance

event - race

Integer

Distance of a race in miles

heat_race

race

Boolean

Signifies a race is a heat race

id

event - race

GUID

Unique ID of a race
ex. 24ba9219-ebe8-4e1f-a21c-71edfd9aaf44

laps

event - race

Integer

Number of laps in a race

name

event - race

String

Name of a race
ex. Cook Out Southern 500

number

event - race

Integer

Race number within a season

parent_id

race

GUID

Unique ID that links events together across seasons (e.g. Daytona 500)
ex. de3f49e0-9393-4d7e-b5a5-3cf5b94a9f38

scheduled

event - race

dateTime

Scheduled date and time of a race
ex. 2022-02-20T19:30:00+00:00

stage_1_laps

event - race

Integer

Number of laps in stage 1

stage_2_laps

event - race

Integer

Number of laps in stage 2

stage_3_laps

event - race

Integer

Number of laps in stage 3

stage_count

event - race

Integer

Number of stages in which a driver can earn stage points

status

event - race

String

Race status
scheduled, created, initialized, practice, qualifying, prerace, inprogress, complete, closed, delayed, canceled, rescheduled, maintenance, warmup, time-tbd

See our FAQ to find a list of statuses and their definitions

Track:
AttributeParent ElementTypeDescription
addressevent - trackStringAddress of a track
ex. 1301 Harry Byrd Hwy
backstretchevent - trackIntegerBackstretch length of a track in feet
bankingevent - trackStringBanking information of a track
ex. Turns:23-25;Backstretch:6;Frontstretch:6
cityevent - trackStringCity of a track
ex. Darlington
completedevent - trackIntegerYear the building of a track was completed
countryevent - trackStringCountry of a track
ex. USA
distanceevent - trackFloatTrack length in miles
ex. 2.66
frontstretchevent - trackIntegerFrontstretch length of a track in feet
idevent - trackGUIDUnique ID of a track
ex. aab526c7-4279-4693-9cb1-90e3c7b974fc
lattrackDecimalLatitude of a track
ex. 29.192994
lngtrackDecimalLongitude of a track
ex. -81.067
marketevent - trackStringMarket of a track
ex. Darlington or Las Vegas
nameevent - trackStringName of a track
ex. Darlington Raceway
ownerevent - trackStringOwner of a track
ex. International Speedway Corp.
shapeevent - trackStringShape of a track
ex. Oval or D-Shaped Oval
stateevent - trackStringState of a track
ex. South Carolina
surfaceevent - trackStringSurface of a track
ex. Paved
track_typeevent - trackStringType of track
ex. Superspeedway
zipevent - trackStringZip code of a track
ex. 29532
Practice and Qualifying:

Attribute

Parent Element

Type

Description

sequence

race - practice

Integer

Sequence number of a practice race

start_time

race - practice

dateTime

Original TV broadcast start time of a practice
ex. 2022-09-04T22:00:00+00:00

status

race - practice

String

Practice status
scheduled, inprogress, complete, delayed, canceled, time-tbd, postponed

See our FAQ to find a list of statuses and their definitions

start_time

race - qualifying

dateTime

Original TV broadcast start time of a qualifying race
ex. 2022-09-04T22:00:00+00:00

Note this appears under qualifying_start_time in the json response

status

race - qualifying

String

Qualifying status
no-qualifying, scheduled, inprogress, delayed, postponed, canceled, complete, time-tbd

See our FAQ to find a list of statuses and their definitions

Note this appears under qualifying_status in the json response

Prior Winner:
AttributeParent ElementTypeDescription
first_namerace - prior_winnerStringFirst name of a prior winner
ex. Denny
full_namerace - prior_winnerStringFull name of a prior winner
ex. Denny Hamlin
idrace - prior_winnerGUIDUnique ID of a prior winner
ex. cb9d6f49-0044-4305-be9a-22d428e52c95
last_namerace - prior_winnerStringLast name of a prior winner
ex. Hamlin
Broadcast:
AttributeParent ElementTypeDescription
cablerace - broadcastStringName of an race's broadcast cable station
internetrace - broadcastStringName of a race's internet stream
networkrace - broadcastStringName of a race's broadcast network
ex. USA
radiorace - broadcastStringName of the race's broadcast radio station
ex. MRN
satelliterace - broadcastStringName of the race's broadcast satellite station
ex. 242
Language
Credentials
Query
Click Try It! to start a request and see the response here!