NASCAR
App · 17 actions
Follow NASCAR's Cup, O'Reilly Auto Parts (formerly Xfinity) and Truck series: the schedule, race results, live leaderboards, lap times, pit stops, standings, drivers and tracks, and start a workflow when a race finishes. No account needed.
Actions
| Action | What it does |
|---|---|
| Get driver | Get a driver's profile (car, team, crew chief, hometown, date of birth, photo) and their championship standing this season in each series they race in. |
| Get driver ratings | Get NASCAR's loop data for a race: each driver's rating (out of 150), green-flag passes, quality passes, fastest laps, laps in the top 15 and average running position. |
| Get driver standings | Get the drivers' championship standings: points, gap to the leader, wins, top 5s, top 10s, poles, laps led, stage wins and playoff points. |
| Get lap times | Get every lap of a race: each driver's lap times, speeds, running position and the flag, for one driver or the whole field. |
| Get lap-by-lap notes | Get NASCAR's lap-by-lap commentary of a race: passes for the lead, incidents, penalties and pit strategy, lap by lap. |
| Get live leaderboard | Get the running order of the series' current session (practice, qualifying or the race) as NASCAR updates it every few seconds: flag, lap, laps to go, stage, and each car's gap, last and best lap, laps led and pit stops. |
| Get manufacturer standings | Get the manufacturers' championship standings (Chevrolet, Ford and Toyota): points and wins. |
| Get owner standings | Get the owners' championship standings, scored per car number whoever drives it: points, wins, top 5s and top 10s. |
| Get pit stops | Get every pit stop of a race, or one driver's: the lap, the flag, which tires were changed, time stopped and on pit road, and places gained or lost. |
| Get practice and qualifying results | Get every practice and qualifying session of a race weekend, with each driver's best lap, speed and laps run, fastest first. |
| Get race | Get a race weekend: when and where it runs, TV and radio, stage lengths and the weekend schedule; once run, the winner, race time, margin, every caution, every lead change, the stage winners and NASCAR's summary. |
| Get race results | Get a race's finishing order: each driver's car, team, start, finish, laps led, status and points. |
| Get track | Get one track's details: location, length, surface, type, banking, turns, capacity, major races, website and map. |
| List drivers | List the drivers nascar.com profiles in a series this season: car number, team, manufacturer, crew chief, hometown, date of birth, photo and profile page. |
| List races | List a season's races in one series, in order: each race's track, start time, TV and radio network, laps, stage lengths, and the winner and pole sitter once it is run. |
| List track sessions | List a season's practice, qualifying and race sessions in one series, with their start times, soonest first. |
| List tracks | List every track NASCAR races at: location, length, surface, type, banking, capacity and website. |
Get driver
Get a driver's profile (car, team, crew chief, hometown, date of birth, photo) and their championship standing this season in each series they race in.
Inputs
- Driver
driver_idtextRequired - The driver. The list holds every driver NASCAR has a profile for.
Outputs
birth_datetext- Date of birth, YYYY-MM-DD.
car_numbertext- Their car number.
crew_chieftext- Their crew chief.
driver_idnumber- NASCAR's id for the driver.
first_nametext- First name.
hometowntext- Where they are from.
is_full_timetrue/false- True for a full-time driver in their series this season.
last_nametext- Last name.
manufacturertext- Chevrolet, Ford or Toyota.
nametext- The driver's name.
photo_urltext- A photo of the driver.
profile_urltext- Their page on nascar.com.
season_statslist- Their standing in each series they have points in this season.
seriestext- The series nascar.com lists them in, e.g. 'Cup Series'.
teamtext- Their team.
twittertext- Their X (Twitter) handle.
Example output
{
"birth_date": "1996-01-11",
"car_number": "45",
"crew_chief": "Billy Scott",
"driver_id": 4065,
"first_name": "Tyler",
"hometown": "Corning, California, United States",
"is_full_time": true,
"last_name": "Reddick",
"manufacturer": "Toyota",
"name": "Tyler Reddick",
"photo_url": "https://www.nascar.com/wp-content/uploads/sites/7/2026/02/06/Tyler-Reddick-1.png",
"profile_url": "https://www.nascar.com/drivers/tyler-reddick",
"season_stats": [
{
"behind_leader": 56,
"behind_next": 12,
"car_number": "45",
"dnfs": 2,
"laps_led": 542,
"manufacturer": "Toyota",
"playoff_points": 0,
"playoff_rank": 3,
"points": 2314,
"poles": 8,
"position": 7,
"season": 2026,
"series": "Cup Series",
"stage_points": 194,
"stage_wins": 2,
"starts": 33,
"top_10": 20,
"top_5": 14,
"wins": 6
}
],
"series": "Cup Series",
"team": "23XI Racing",
"twitter": "@TylerReddick"
}Get driver ratings
Get NASCAR's loop data for a race: each driver's rating (out of 150), green-flag passes, quality passes, fastest laps, laps in the top 15 and average running position. Published for races from 2019 on.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest.
Outputs
countnumber- How many there are in the list.
driverslist- Each driver's loop data, in finishing order.
raceobject- The race.
Example output
{
"count": 2,
"drivers": [
{
"average_position": 7.21,
"best_position": 1,
"car_number": "45",
"closing_laps_gained": 1,
"closing_position": 2,
"driver": "Tyler Reddick",
"driver_id": 4065,
"driver_rating": 115.96,
"fastest_laps": 17,
"finish": 1,
"green_flag_passes": 105,
"laps": 312,
"laps_led": 18,
"mid_race_position": 7,
"passing_differential": 10,
"quality_passes": 61,
"start": 6,
"times_passed": 95,
"top_15_laps": 300,
"worst_position": 35
},
{
"average_position": 4.89,
"best_position": 1,
"car_number": "12",
"closing_laps_gained": 1,
"closing_position": 3,
"driver": "Ryan Blaney",
"driver_id": 4023,
"driver_rating": 121.19,
"fastest_laps": 41,
"finish": 2,
"green_flag_passes": 102,
"laps": 312,
"laps_led": 51,
"mid_race_position": 5,
"passing_differential": 24,
"quality_passes": 72,
"start": 1,
"times_passed": 78,
"top_15_laps": 309,
"worst_position": 22
}
],
"race": {
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
}
}Get driver standings
Get the drivers' championship standings: points, gap to the leader, wins, top 5s, top 10s, poles, laps led, stage wins and playoff points.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current.
Outputs
countnumber- How many there are in the list.
leadertext- Who leads.
seasonnumber- The season (year), e.g. 2026.
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
standingslist- The standings, leader first.
Example output
{
"count": 2,
"leader": "Kyle Larson",
"season": 2026,
"series": "Cup Series",
"standings": [
{
"behind_leader": 0,
"behind_next": 0,
"car_number": "5",
"dnfs": 4,
"driver": "Kyle Larson",
"driver_id": 4030,
"laps_led": 1215,
"manufacturer": "Chevrolet",
"playoff_points": 0,
"playoff_rank": 7,
"points": 2370,
"poles": 2,
"position": 1,
"stage_points": 271,
"stage_wins": 9,
"starts": 33,
"top_10": 19,
"top_5": 14,
"wins": 2
},
{
"behind_leader": 5,
"behind_next": 5,
"car_number": "20",
"dnfs": 4,
"driver": "Christopher Bell",
"driver_id": 4153,
"laps_led": 792,
"manufacturer": "Toyota",
"playoff_points": 0,
"playoff_rank": 6,
"points": 2365,
"poles": 1,
"position": 2,
"stage_points": 251,
"stage_wins": 6,
"starts": 33,
"top_10": 18,
"top_5": 15,
"wins": 1
}
]
}Get lap times
Get every lap of a race: each driver's lap times, speeds, running position and the flag, for one driver or the whole field. Published for races from 2020 on.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest. - Driver
driver_idtext - Only this driver. The list shows the drivers entered in the race. Leave it empty for every driver.
Outputs
countnumber- How many there are in the list.
driverslist- Each driver's laps, in finishing order.
raceobject- The race.
Example output
{
"count": 1,
"drivers": [
{
"best_lap_time": 27.468,
"car_number": "45",
"driver": "Tyler Reddick",
"driver_id": 4065,
"lap_count": 3,
"laps": [
{
"flag": "Green",
"lap": 1,
"position": 6,
"speed_mph": 128.466,
"time": 28.023
},
{
"flag": "Green",
"lap": 2,
"position": 6,
"speed_mph": 131.062,
"time": 27.468
},
{
"flag": "Green",
"lap": 3,
"position": 6,
"speed_mph": 130.648,
"time": 27.555
}
],
"manufacturer": "Toyota",
"position": 1
}
],
"race": {
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125,
127
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
}
}Get lap-by-lap notes
Get NASCAR's lap-by-lap commentary of a race: passes for the lead, incidents, penalties and pit strategy, lap by lap. Published for races from 2020 on.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest.
Outputs
countnumber- How many there are in the list.
noteslist- The notes, in lap order.
raceobject- The race.
Example output
{
"count": 2,
"notes": [
{
"driver_ids": [
4059
],
"flag": "Green",
"lap": 0,
"note": "Practice: #43 had a flat tire",
"note_id": 68162
},
{
"driver_ids": [
4368
],
"flag": "Green",
"lap": 0,
"note": "To the rear: #54 (unapproved adjustments)",
"note_id": 68224
}
],
"race": {
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
}
}Get live leaderboard
Get the running order of the series' current session (practice, qualifying or the race) as NASCAR updates it every few seconds: flag, lap, laps to go, stage, and each car's gap, last and best lap, laps led and pit stops. Between race weekends it shows the last session run.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup.
Outputs
caution_countnumber- Cautions so far.
caution_lapsnumber- Laps run under caution so far.
countnumber- How many there are in the list.
flagtext- 'Green', 'Caution', 'Red', 'White', 'Checkered', 'Pre-race' or 'Track closed' (no session running).
is_session_overtrue/false- True once the session has finished.
lapnumber- The leader's current lap.
laps_to_gonumber- Laps to go.
lead_change_countnumber- Lead changes so far.
leadertext- Who is leading.
leader_countnumber- Drivers who have led.
leaderboardlist- Every car, leader first.
racetext- The race weekend's race.
race_idnumber- NASCAR's id for the race weekend.
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
sessiontext- The session on track, e.g. 'Final Practice' or the race's name.
session_typetext- 'Practice', 'Qualifying' or 'Race'.
stagenumber- The stage being run.
stage_ends_on_lapnumber- The lap the stage ends on.
total_lapsnumber- Laps scheduled.
tracktext- The track.
updated_attext- When NASCAR last updated it, in UTC.
Example output
{
"caution_count": 6,
"caution_laps": 43,
"count": 2,
"flag": "Track closed",
"is_session_over": true,
"lap": 312,
"laps_to_go": 0,
"lead_change_count": 21,
"leader": "Tyler Reddick",
"leader_count": 10,
"leaderboard": [
{
"behind_leader": 0.0,
"best_lap": 2,
"best_lap_speed_mph": 131.062,
"best_lap_time": 27.468,
"car_number": "45",
"driver": "Tyler Reddick",
"driver_id": 4065,
"gap": "Leader",
"is_in_playoffs": true,
"is_on_track": true,
"is_points_eligible": true,
"is_rookie": false,
"laps_completed": 312,
"laps_led": 18,
"last_lap_speed_mph": 124.77,
"last_lap_time": 28.853,
"manufacturer": "Toyota",
"pit_stops": 8,
"position": 1,
"sponsor": "ROCKSTAR ENERGY DRINK",
"starting_position": 6
},
{
"behind_leader": 0.801,
"best_lap": 2,
"best_lap_speed_mph": 132.836,
"best_lap_time": 27.101,
"car_number": "12",
"driver": "Ryan Blaney",
"driver_id": 4023,
"gap": "+0.801s",
"is_in_playoffs": true,
"is_on_track": true,
"is_points_eligible": true,
"is_rookie": false,
"laps_completed": 312,
"laps_led": 51,
"last_lap_speed_mph": 125.191,
"last_lap_time": 28.756,
"manufacturer": "Ford",
"pit_stops": 9,
"position": 2,
"sponsor": "Menards/Richmond Water Heaters",
"starting_position": 1
}
],
"race": "Freeway Insurance 500",
"race_id": 5633,
"series": "Cup Series",
"session": "Freeway Insurance 500",
"session_type": "Race",
"stage": 3,
"stage_ends_on_lap": 312,
"total_laps": 312,
"track": "Phoenix Raceway",
"updated_at": null
}Get manufacturer standings
Get the manufacturers' championship standings (Chevrolet, Ford and Toyota): points and wins. NASCAR publishes them from 2019 on.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current.
Outputs
countnumber- How many there are in the list.
leadertext- Who leads.
seasonnumber- The season (year), e.g. 2026.
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
standingslist- The standings, leader first.
Example output
{
"count": 2,
"leader": "Toyota",
"season": 2026,
"series": "Cup Series",
"standings": [
{
"behind_leader": 0,
"manufacturer": "Toyota",
"points": 1491,
"position": 1,
"wins": 18
},
{
"behind_leader": 219,
"manufacturer": "Chevrolet",
"points": 1272,
"position": 2,
"wins": 8
}
]
}Get owner standings
Get the owners' championship standings, scored per car number whoever drives it: points, wins, top 5s and top 10s. NASCAR publishes them from 2019 on.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current.
Outputs
countnumber- How many there are in the list.
leadertext- Who leads.
seasonnumber- The season (year), e.g. 2026.
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
standingslist- The standings, leader first.
Example output
{
"count": 2,
"leader": "Hendrick Motorsports",
"season": 2026,
"series": "Cup Series",
"standings": [
{
"behind_leader": 0,
"behind_next": 0,
"car_number": "5",
"dnfs": 4,
"owner": "Hendrick Motorsports",
"owner_id": 1464,
"points": 2370,
"poles": 0,
"position": 1,
"starts": 33,
"top_10": 19,
"top_5": 14,
"wins": 2
},
{
"behind_leader": 5,
"behind_next": 5,
"car_number": "20",
"dnfs": 4,
"owner": "Joe Gibbs Racing",
"owner_id": 4047,
"points": 2365,
"poles": 1,
"position": 2,
"starts": 33,
"top_10": 18,
"top_5": 15,
"wins": 1
}
]
}Get pit stops
Get every pit stop of a race, or one driver's: the lap, the flag, which tires were changed, time stopped and on pit road, and places gained or lost. Published for races from 2020 on.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest. - Driver
driver_idtext - Only this driver. The list shows the drivers entered in the race. Leave it empty for every driver.
Outputs
countnumber- How many there are in the list.
pit_stopslist- The pit stops, in the order they were made.
raceobject- The race.
Example output
{
"count": 2,
"pit_stops": [
{
"car_number": "45",
"driver": "Tyler Reddick",
"driver_id": 4065,
"flag": "Caution",
"lap": 45,
"leader_lap": 45,
"manufacturer": "Toyota",
"pit_in_race_time": 1367.063,
"pit_road_seconds": 45.404,
"position_in": 7,
"position_out": 10,
"positions_gained": -3,
"stop_seconds": 9.796,
"stop_type": "Four tires",
"tires_changed": [
"left front",
"left rear"
]
},
{
"car_number": "45",
"driver": "Tyler Reddick",
"driver_id": 4065,
"flag": "Caution",
"lap": 63,
"leader_lap": 63,
"manufacturer": "Toyota",
"pit_in_race_time": 2200.549,
"pit_road_seconds": 41.961,
"position_in": 9,
"position_out": 7,
"positions_gained": 2,
"stop_seconds": 5.396,
"stop_type": "Right-side tires",
"tires_changed": [
"right front",
"right rear"
]
}
],
"race": {
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
}
}Get practice and qualifying results
Get every practice and qualifying session of a race weekend, with each driver's best lap, speed and laps run, fastest first.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest.
Outputs
countnumber- How many there are in the list.
raceobject- The race.
sessionslist- The sessions, in order.
Example output
{
"count": 2,
"race": {
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
},
"sessions": [
{
"count": 2,
"results": [
{
"behind_leader": 0,
"best_lap": 33,
"best_lap_speed_mph": 133.487,
"best_lap_time": 26.969,
"car_number": "12",
"comment": null,
"driver": "Ryan Blaney",
"driver_id": 4023,
"laps": 77,
"manufacturer": "Ford",
"position": 1
},
{
"behind_leader": 0.029,
"best_lap": 2,
"best_lap_speed_mph": 133.343,
"best_lap_time": 26.998,
"car_number": "77",
"comment": null,
"driver": "Carson Hocevar",
"driver_id": 4326,
"laps": 61,
"manufacturer": "Chevrolet",
"position": 2
}
],
"session": "NCS Final Practice",
"session_type": "Practice",
"starts_at": "2026-10-17T20:30:00Z"
},
{
"count": 2,
"results": [
{
"behind_leader": 0,
"best_lap": 1,
"best_lap_speed_mph": 137.143,
"best_lap_time": 26.25,
"car_number": "12",
"comment": null,
"driver": "Ryan Blaney",
"driver_id": 4023,
"laps": 1,
"manufacturer": "Ford",
"position": 1
},
{
"behind_leader": 0.032,
"best_lap": 1,
"best_lap_speed_mph": 136.976,
"best_lap_time": 26.282,
"car_number": "22",
"comment": null,
"driver": "Joey Logano",
"driver_id": 3859,
"laps": 1,
"manufacturer": "Ford",
"position": 2
}
],
"session": "Freeway Insurance 500 Busch Pole Qualifying",
"session_type": "Qualifying",
"starts_at": "2026-10-18T19:00:00Z"
}
]
}Get race
Get a race weekend: when and where it runs, TV and radio, stage lengths and the weekend schedule; once run, the winner, race time, margin, every caution, every lead change, the stage winners and NASCAR's summary.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest.
Outputs
average_speed_mphnumber- The winner's average speed in mph.
cars_in_fieldnumber- How many cars started (or are entered).
caution_countnumber- How many cautions there were.
caution_lapsnumber- Laps run under caution.
cautionslist- Every caution, in order.
is_playoff_racetrue/false- True for a playoff race.
is_points_racetrue/false- True for a championship race; false for an exhibition such as the Clash, the Duels or the All-Star Race.
laps_runnumber- Laps run, which can differ from the schedule (overtime).
lead_change_countnumber- How many times the lead changed.
lead_changeslist- Every spell in the lead, in order.
leader_countnumber- How many drivers led.
margin_of_victorytext- The winning margin in seconds, e.g. '.801'.
miles_runnumber- Miles run.
nametext- The race's name, e.g. 'DAYTONA 500'.
pole_winnerobject- Who started first, or empty before qualifying.
race_idnumber- NASCAR's id for the race.
race_timetext- How long the race took, e.g. '3:01:23'.
radiotext- The radio network, e.g. 'MRN' or 'PRN'.
satellite_radiotext- The satellite radio channel, e.g. 'SIRIUSXM'.
schedulelist- The race weekend's schedule.
scheduled_lapsnumber- Laps the race is scheduled for.
scheduled_milesnumber- Miles the race is scheduled for.
seasonnumber- The season (year).
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
stage_lapslist- Each stage's length in laps, e.g. [60, 125, 127].
stageslist- Each finished stage's top 10.
starts_attext- When the race goes green, in UTC (ISO 8601).
statustext- 'upcoming', 'in progress', 'finished', or 'awaiting results' for a race run but not yet scored.
summarytext- NASCAR's one-paragraph summary of the race, once it is run.
tracktext- The track, e.g. 'Daytona International Speedway'.
track_idnumber- NASCAR's id for the track.
tvtext- The TV network showing the race in the US, e.g. 'FOX'.
winnerobject- A driver, or empty when there is none yet.
Example output
{
"average_speed_mph": 103.207,
"cars_in_field": 37,
"caution_count": 6,
"caution_laps": 43,
"cautions": [
{
"comment": "#35, 71 Incident Turn 3",
"end_lap": 50,
"free_pass_car": "60",
"reason": "Accident",
"start_lap": 45
},
{
"comment": "Stage 1 Conclusion",
"end_lap": 68,
"free_pass_car": "35",
"reason": "Competition",
"start_lap": 62
}
],
"is_playoff_race": true,
"is_points_race": true,
"laps_run": 312,
"lead_change_count": 21,
"lead_changes": [
{
"car_number": "12",
"driver": "Ryan Blaney",
"driver_id": 4023,
"end_lap": 46,
"start_lap": 1
},
{
"car_number": "11",
"driver": "Denny Hamlin",
"driver_id": 1361,
"end_lap": 50,
"start_lap": 47
}
],
"leader_count": 10,
"margin_of_victory": ".801",
"miles_run": 312.0,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"race_time": "3:01:23",
"radio": "MRN",
"satellite_radio": "SIRIUSXM",
"schedule": [
{
"event": "Driver / Crew Chief Meeting",
"is_on_track": false,
"notes": "Sent Electronically",
"session_type": "Other",
"starts_at": "2026-10-16T00:00:00Z"
},
{
"event": "Haulers Enter",
"is_on_track": false,
"notes": "Equipment Unloading",
"session_type": "Other",
"starts_at": "2026-10-17T13:00:00Z"
}
],
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"stages": [
{
"results": [
{
"car_number": "22",
"driver": "Joey Logano",
"driver_id": 3859,
"position": 1,
"stage_points": 10
},
{
"car_number": "11",
"driver": "Denny Hamlin",
"driver_id": 1361,
"position": 2,
"stage_points": 9
}
],
"stage": 1
},
{
"results": [
{
"car_number": "22",
"driver": "Joey Logano",
"driver_id": 3859,
"position": 1,
"stage_points": 10
},
{
"car_number": "19",
"driver": "Chase Briscoe",
"driver_id": 4228,
"position": 2,
"stage_points": 9
}
],
"stage": 2
}
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"summary": "Tyler Reddick has won the Freeway Insurance 500 at Phoenix Raceway, his 14th victory in the NASCAR Cup Series. Prior to the start of the race, the following vehicle(s) dropped to the rear of the field under penalty: No. 54 (Unapproved Adjustments).",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
}Get race results
Get a race's finishing order: each driver's car, team, start, finish, laps led, status and points. Before the race is run it lists the drivers entered instead.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Race
racetext - Which race. Pick 'Most recent finished race' or 'Next race' and the step follows the season along, or choose one race from the list.Default:
latest.
Outputs
countnumber- How many there are in the list.
is_finishedtrue/false- True once the race is run. False means 'results' is the entry list, with no positions yet.
raceobject- The race.
resultslist- Every car, winner first (or by starting spot before the race).
winnertext- The winner's name, once the race is run.
Example output
{
"count": 2,
"is_finished": true,
"race": {
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
},
"results": [
{
"car_number": "45",
"crew_chief": "Billy Scott",
"driver": "Tyler Reddick",
"driver_id": 4065,
"is_disqualified": false,
"laps_completed": 312,
"laps_led": 18,
"manufacturer": "Toyota",
"owner": "23XI Racing",
"playoff_points": 0,
"points": 61,
"points_position": 7,
"position": 1,
"qualifying_speed_mph": 136.374,
"sponsor": "Rockstar Energy Drink",
"starting_position": 6,
"status": "Running",
"team": "23XI Racing"
},
{
"car_number": "12",
"crew_chief": "Jonathan Hassler",
"driver": "Ryan Blaney",
"driver_id": 4023,
"is_disqualified": false,
"laps_completed": 312,
"laps_led": 51,
"manufacturer": "Ford",
"owner": "Team Penske",
"playoff_points": 0,
"points": 48,
"points_position": 5,
"position": 2,
"qualifying_speed_mph": 137.143,
"sponsor": "Menards\\Richmond Water Heaters",
"starting_position": 1,
"status": "Running",
"team": "Team Penske"
}
],
"winner": "Tyler Reddick"
}Get track
Get one track's details: location, length, surface, type, banking, turns, capacity, major races, website and map.
Inputs
- Track
track_idtextRequired - The track.
Outputs
addresstext- Street address.
bankingtext- How steeply the turns and straights are banked.
capacitytext- Seating capacity, as NASCAR writes it.
citytext- City.
descriptiontext- NASCAR's description of the track.
image_urltext- A map of the track.
length_milesnumber- Length of a lap in miles.
logo_urltext- The track's logo.
major_eventstext- The track's major races.
nametext- The track's name.
statetext- State, e.g. 'FL'.
surfacetext- Asphalt or concrete.
tickets_urltext- Where to buy tickets.
track_idnumber- NASCAR's id for the track.
track_typetext- e.g. 'Superspeedway', 'Intermediate', 'Short Track', 'Road Course'.
turnsnumber- Number of turns.
websitetext- The track's website.
year_builtnumber- Year built.
ziptext- ZIP code.
Example output
{
"address": "7602 S 115th Avenue",
"banking": "Turns 1-2: 9; Turns 3-4: 11; Backstretch: 3; Frontstretch: 9",
"capacity": "42,000",
"city": "Avondale",
"description": "5 cornered, off-set tri-oval. Turns 1 and 2 banked at 9 degrees, turns 3 and 4 banked at 11 degrees, straightaways are flat.",
"image_url": "https://www.nascar.com/wp-content/uploads/sites/7/2021/06/24/84.png",
"length_miles": 1.0,
"logo_url": "https://www.nascar.com/wp-content/uploads/sites/7/2022/03/07/PR-Logo-3C-Horizontal.png",
"major_events": "Instacart 500, NASCAR Championship Race",
"name": "Phoenix Raceway",
"state": "AZ",
"surface": "Asphalt",
"tickets_url": "https://www.phoenixraceway.com/schedule/",
"track_id": 84,
"track_type": "Intermediate",
"turns": 4,
"website": "https://www.phoenixraceway.com",
"year_built": 1964,
"zip": "85323"
}List drivers
List the drivers nascar.com profiles in a series this season: car number, team, manufacturer, crew chief, hometown, date of birth, photo and profile page.
Inputs
- Series
seriestext - Which series' drivers. Leave it empty for all three.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series).
Outputs
countnumber- How many there are in the list.
driverslist- The drivers, by last name.
seriestext- The series.
Example output
{
"count": 2,
"drivers": [
{
"birth_date": "1981-12-16",
"car_number": "16",
"crew_chief": "Trent Owens",
"driver_id": 3774,
"first_name": "AJ",
"hometown": "Los Gatos, California, United States",
"is_full_time": true,
"last_name": "Allmendinger",
"manufacturer": "Chevrolet",
"name": "AJ Allmendinger",
"photo_url": "https://www.nascar.com/wp-content/uploads/sites/7/2026/01/26/AJ-Allmendinger_resized.png",
"profile_url": "https://www.nascar.com/drivers/aj-allmendinger",
"series": "Cup Series",
"team": "Kaulig Racing",
"twitter": "@AJDinger"
},
{
"birth_date": "1984-03-14",
"car_number": "19",
"crew_chief": "Seth Chavka",
"driver_id": 40,
"first_name": "Aric",
"hometown": null,
"is_full_time": true,
"last_name": "Almirola",
"manufacturer": "Toyota",
"name": "Aric Almirola",
"photo_url": "https://www.nascar.com/wp-content/uploads/sites/7/2024/04/08/aric-almirola.png",
"profile_url": "https://www.nascar.com/drivers/aric-almirola",
"series": "Cup Series",
"team": "Joe Gibbs Racing",
"twitter": null
}
],
"series": "Cup Series"
}List races
List a season's races in one series, in order: each race's track, start time, TV and radio network, laps, stage lengths, and the winner and pole sitter once it is run.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Which races
whichtext - Every race, only those still to run, or only finished ones.One of:
all(Every race),upcoming(Races still to run),finished(Finished races). Default:all.
Outputs
countnumber- How many there are in the list.
raceslist- The races, in the order they are run.
seasonnumber- The season (year), e.g. 2026.
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
Example output
{
"count": 2,
"races": [
{
"is_playoff_race": true,
"is_points_race": true,
"name": "Freeway Insurance 500",
"pole_winner": {
"driver_id": 4023,
"name": "Ryan Blaney",
"speed_mph": 137.143
},
"race_id": 5633,
"radio": "MRN",
"scheduled_laps": 312,
"scheduled_miles": 312.0,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
60,
125
],
"starts_at": "2026-10-18T19:00:00Z",
"status": "finished",
"track": "Phoenix Raceway",
"track_id": 84,
"tv": "USA",
"winner": {
"driver_id": 4065,
"name": "Tyler Reddick"
}
},
{
"is_playoff_race": true,
"is_points_race": true,
"name": "YellaWood 500",
"pole_winner": null,
"race_id": 5631,
"radio": "MRN",
"scheduled_laps": 188,
"scheduled_miles": 500.08,
"season": 2026,
"series": "Cup Series",
"stage_laps": [
98,
45
],
"starts_at": "2026-10-25T18:00:00Z",
"status": "upcoming",
"track": "Talladega Superspeedway",
"track_id": 82,
"tv": "NBC",
"winner": null
}
],
"season": 2026,
"series": "Cup Series"
}List track sessions
List a season's practice, qualifying and race sessions in one series, with their start times, soonest first. Handy for a reminder before the cars go out.
Inputs
- Series
seriestext - Which NASCAR series.One of:
cup(Cup Series),oreilly(O'Reilly Auto Parts Series (formerly Xfinity)),truck(Truck Series). Default:cup. - Season
seasontext - Which season. 'Current season' keeps the step working next year without being edited. Seasons from 2018 on.One of:
current(Current season),2026,2025,2024,2023,2022,2021,2020,2019,2018. Default:current. - Only upcoming sessions
upcoming_onlytrue/false - Leave on for sessions still to come; turn off for the whole season.Default:
true.
Outputs
countnumber- How many there are in the list.
seasonnumber- The season (year), e.g. 2026.
seriestext- The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
sessionslist- The sessions, soonest first.
Example output
{
"count": 2,
"season": 2026,
"series": "Cup Series",
"sessions": [
{
"ends_at": "2026-11-06T23:20:00Z",
"race": "NASCAR Championship Race",
"race_id": 5601,
"session": "Practice",
"session_type": "Practice",
"starts_at": "2026-11-06T22:30:00Z",
"track": "Homestead-Miami Speedway",
"track_id": 40
},
{
"ends_at": "2026-11-07T20:30:00Z",
"race": "NASCAR Championship Race",
"race_id": 5601,
"session": "Qualifying (Impound)",
"session_type": "Qualifying",
"starts_at": "2026-11-07T19:30:00Z",
"track": "Homestead-Miami Speedway",
"track_id": 40
}
]
}List tracks
List every track NASCAR races at: location, length, surface, type, banking, capacity and website.
Inputs
None.
Outputs
countnumber- How many there are in the list.
trackslist- The tracks, by name.
Example output
{
"count": 2,
"tracks": [
{
"address": "9300 Cherry Avenue",
"banking": "Turns:14;Backstretch:3:Frontstretch:11",
"capacity": "71,000",
"city": "Hampton",
"description": "The track is tri-oval in shape., designed after Michigan speedway. Built on the site of the old Kaiser Steel plant. Turns banked at 14 degrees, Tri-oval banked at 11 degrees, backstretch banked at 3 degrees.",
"image_url": "https://www.nascar.com/wp-content/uploads/sites/7/2021/06/24/111.png",
"length_miles": 1.54,
"logo_url": "https://www.nascar.com/wp-content/uploads/sites/7/2022/03/14/Atlanta-Motor-Speedway.png",
"major_events": "Ambetter Health 400, Quaker State 400",
"name": "Auto Club Speedway",
"state": "GA",
"surface": "Asphalt",
"tickets_url": "https://www.atlantamotorspeedway.com/tickets/",
"track_id": 38,
"track_type": "Intermediate",
"turns": 4,
"website": "https://www.atlantamotorspeedway.com/",
"year_built": 1960,
"zip": "92335"
},
{
"address": null,
"banking": null,
"capacity": "110,000",
"city": "Mexico City",
"description": null,
"image_url": "https://www.nascar.com/wp-content/uploads/sites/7/2024/09/06/75.svg",
"length_miles": 2.674,
"logo_url": "https://www.nascar.com/wp-content/uploads/sites/7/2025/03/26/NASCAR-Mexico_Primary_4C-2_OPTIMIZED.png",
"major_events": null,
"name": "Aut\u00f3dromo Hermanos Rodr\u00edguez",
"state": "Mexico",
"surface": "Paved",
"tickets_url": null,
"track_id": 75,
"track_type": "Road Course",
"turns": null,
"website": "https://nascarmexico.com/?LANG=LANG_EN",
"year_built": 1959,
"zip": null
}
]
}