# NASCAR

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

App · 17 actions. Web page: https://docs.lodol.com/docs/integrations/nascar

## Actions

### 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_id`, text, required): The driver. The list holds every driver NASCAR has a profile for.

**Outputs**

- `birth_date` (text): Date of birth, YYYY-MM-DD.
- `car_number` (text): Their car number.
- `crew_chief` (text): Their crew chief.
- `driver_id` (number): NASCAR's id for the driver.
- `first_name` (text): First name.
- `hometown` (text): Where they are from.
- `is_full_time` (true/false): True for a full-time driver in their series this season.
- `last_name` (text): Last name.
- `manufacturer` (text): Chevrolet, Ford or Toyota.
- `name` (text): The driver's name.
- `photo_url` (text): A photo of the driver.
- `profile_url` (text): Their page on nascar.com.
- `season_stats` (list): Their standing in each series they have points in this season.
- `series` (text): The series nascar.com lists them in, e.g. 'Cup Series'.
- `team` (text): Their team.
- `twitter` (text): Their X (Twitter) handle.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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**

- `count` (number): How many there are in the list.
- `drivers` (list): Each driver's loop data, in finishing order.
- `race` (object): The race.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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**

- `count` (number): How many there are in the list.
- `leader` (text): Who leads.
- `season` (number): The season (year), e.g. 2026.
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
- `standings` (list): The standings, leader first.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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_id`, text): Only this driver. The list shows the drivers entered in the race. Leave it empty for every driver.

**Outputs**

- `count` (number): How many there are in the list.
- `drivers` (list): Each driver's laps, in finishing order.
- `race` (object): The race.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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**

- `count` (number): How many there are in the list.
- `notes` (list): The notes, in lap order.
- `race` (object): The race.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.

**Outputs**

- `caution_count` (number): Cautions so far.
- `caution_laps` (number): Laps run under caution so far.
- `count` (number): How many there are in the list.
- `flag` (text): 'Green', 'Caution', 'Red', 'White', 'Checkered', 'Pre-race' or 'Track closed' (no session running).
- `is_session_over` (true/false): True once the session has finished.
- `lap` (number): The leader's current lap.
- `laps_to_go` (number): Laps to go.
- `lead_change_count` (number): Lead changes so far.
- `leader` (text): Who is leading.
- `leader_count` (number): Drivers who have led.
- `leaderboard` (list): Every car, leader first.
- `race` (text): The race weekend's race.
- `race_id` (number): NASCAR's id for the race weekend.
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
- `session` (text): The session on track, e.g. 'Final Practice' or the race's name.
- `session_type` (text): 'Practice', 'Qualifying' or 'Race'.
- `stage` (number): The stage being run.
- `stage_ends_on_lap` (number): The lap the stage ends on.
- `total_laps` (number): Laps scheduled.
- `track` (text): The track.
- `updated_at` (text): When NASCAR last updated it, in UTC.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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**

- `count` (number): How many there are in the list.
- `leader` (text): Who leads.
- `season` (number): The season (year), e.g. 2026.
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
- `standings` (list): The standings, leader first.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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**

- `count` (number): How many there are in the list.
- `leader` (text): Who leads.
- `season` (number): The season (year), e.g. 2026.
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
- `standings` (list): The standings, leader first.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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_id`, text): Only this driver. The list shows the drivers entered in the race. Leave it empty for every driver.

**Outputs**

- `count` (number): How many there are in the list.
- `pit_stops` (list): The pit stops, in the order they were made.
- `race` (object): The race.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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**

- `count` (number): How many there are in the list.
- `race` (object): The race.
- `sessions` (list): The sessions, in order.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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_mph` (number): The winner's average speed in mph.
- `cars_in_field` (number): How many cars started (or are entered).
- `caution_count` (number): How many cautions there were.
- `caution_laps` (number): Laps run under caution.
- `cautions` (list): Every caution, in order.
- `is_playoff_race` (true/false): True for a playoff race.
- `is_points_race` (true/false): True for a championship race; false for an exhibition such as the Clash, the Duels or the All-Star Race.
- `laps_run` (number): Laps run, which can differ from the schedule (overtime).
- `lead_change_count` (number): How many times the lead changed.
- `lead_changes` (list): Every spell in the lead, in order.
- `leader_count` (number): How many drivers led.
- `margin_of_victory` (text): The winning margin in seconds, e.g. '.801'.
- `miles_run` (number): Miles run.
- `name` (text): The race's name, e.g. 'DAYTONA 500'.
- `pole_winner` (object): Who started first, or empty before qualifying.
- `race_id` (number): NASCAR's id for the race.
- `race_time` (text): How long the race took, e.g. '3:01:23'.
- `radio` (text): The radio network, e.g. 'MRN' or 'PRN'.
- `satellite_radio` (text): The satellite radio channel, e.g. 'SIRIUSXM'.
- `schedule` (list): The race weekend's schedule.
- `scheduled_laps` (number): Laps the race is scheduled for.
- `scheduled_miles` (number): Miles the race is scheduled for.
- `season` (number): The season (year).
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
- `stage_laps` (list): Each stage's length in laps, e.g. [60, 125, 127].
- `stages` (list): Each finished stage's top 10.
- `starts_at` (text): When the race goes green, in UTC (ISO 8601).
- `status` (text): 'upcoming', 'in progress', 'finished', or 'awaiting results' for a race run but not yet scored.
- `summary` (text): NASCAR's one-paragraph summary of the race, once it is run.
- `track` (text): The track, e.g. 'Daytona International Speedway'.
- `track_id` (number): NASCAR's id for the track.
- `tv` (text): The TV network showing the race in the US, e.g. 'FOX'.
- `winner` (object): A driver, or empty when there is none yet.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`race`, text): 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**

- `count` (number): How many there are in the list.
- `is_finished` (true/false): True once the race is run. False means 'results' is the entry list, with no positions yet.
- `race` (object): The race.
- `results` (list): Every car, winner first (or by starting spot before the race).
- `winner` (text): The winner's name, once the race is run.

**Example output**

```json
{
  "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_id`, text, required): The track.

**Outputs**

- `address` (text): Street address.
- `banking` (text): How steeply the turns and straights are banked.
- `capacity` (text): Seating capacity, as NASCAR writes it.
- `city` (text): City.
- `description` (text): NASCAR's description of the track.
- `image_url` (text): A map of the track.
- `length_miles` (number): Length of a lap in miles.
- `logo_url` (text): The track's logo.
- `major_events` (text): The track's major races.
- `name` (text): The track's name.
- `state` (text): State, e.g. 'FL'.
- `surface` (text): Asphalt or concrete.
- `tickets_url` (text): Where to buy tickets.
- `track_id` (number): NASCAR's id for the track.
- `track_type` (text): e.g. 'Superspeedway', 'Intermediate', 'Short Track', 'Road Course'.
- `turns` (number): Number of turns.
- `website` (text): The track's website.
- `year_built` (number): Year built.
- `zip` (text): ZIP code.

**Example output**

```json
{
  "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 (`series`, text): 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**

- `count` (number): How many there are in the list.
- `drivers` (list): The drivers, by last name.
- `series` (text): The series.

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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 (`which`, text): 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**

- `count` (number): How many there are in the list.
- `races` (list): The races, in the order they are run.
- `season` (number): The season (year), e.g. 2026.
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).

**Example output**

```json
{
  "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 (`series`, text): Which NASCAR series. One of: `cup` (Cup Series), `oreilly` (O'Reilly Auto Parts Series (formerly Xfinity)), `truck` (Truck Series). Default: `cup`.
- Season (`season`, text): 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_only`, true/false): Leave on for sessions still to come; turn off for the whole season. Default: `true`.

**Outputs**

- `count` (number): How many there are in the list.
- `season` (number): The season (year), e.g. 2026.
- `series` (text): The series, e.g. 'Cup Series' ('Xfinity Series' before 2026).
- `sessions` (list): The sessions, soonest first.

**Example output**

```json
{
  "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**

- `count` (number): How many there are in the list.
- `tracks` (list): The tracks, by name.

**Example output**

```json
{
  "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
    }
  ]
}
```
