---
updatedAt: 2026-03-03T15:32:20.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/racing/llms.txt
---

# Race Status Workflow

## Intro

Every NASCAR race progresses through multiple statuses over its lifecycle. The **Status** data point indicates the current state of a race and should be used to determine which endpoint is most appropriate for retrieving accurate and timely data.

The **Status** data point is available in every **Schedule** and **Leaderboard** endpoint and reflects changes as a race moves from scheduled to in progress and ultimately to closed. For example, to retrieve a race’s initial status and scheduling information, it is most appropriate to request the <Anchor label="Schedule" target="_blank" href="ref:nascar-schedule">Schedule</Anchor> endpoint.

In the examples below, the `status` attribute represents the **Status** data point and shows the race is currently scheduled.

```xml Schedule Snippet (XML)
 <race id="38125d3a-ade5-416b-a570-6a27ce0b0ec1" name="Clash Heat Race 1" status="scheduled" distance="15" laps="25" chase_race="false" heat_race="true" award_pole="false" stage_count="0" scheduled="2026-02-01T01:30:00+00:00">
```
```json Schedule Snippet (JSON)
   "races": [
        {
          "id": "38125d3a-ade5-416b-a570-6a27ce0b0ec1",
          "name": "Clash Heat Race 1",
          "status": "scheduled",
          "distance": 15,
          "laps": 25,
          "chase_race": false,
          "heat_race": true,
          "award_pole": false,
          "stage_count": 0,
          "scheduled": "2026-02-01T01:30:00+00:00",
          "broadcast": {
            "network": "FS1",
            "satellite": "219",
            "radio": "MRN"
          },
          "prior_winner": {
            "first_name": "Chase",
            "last_name": "Elliott",
            "full_name": "Chase Elliott",
            "id": "5fd3e3fb-322f-4157-ae41-9317fba1997d"
          }
        },
```

**Note**: In NASCAR, postponed and rescheduled races retain the same race ID and resume under the original race record unless it goes to a new race weekend later in the season.

<br />

***

## Coverage

Our NASCAR API provides real-time updates for Cup, O'Reilly Auto Parts, and Truck events. Each race, practice and qualifying event updates live, with lap-by-lap coverage.

<br />

## Race Status Definitions

Below are each of the valid race statuses you can expect to see in the NASCAR API. Reference these definitions for precise detail on what each race state signifies.

* `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. We would recommend against pulling data for a race while in this status.
* `warmup` – The scheduled race is set to take place and will begin soon.
* `time-tbd` - The race time is yet to be determined.

<br />

***

## Race Workflows

See the below diagrams for common race status flows, with context around each update.

<br />

### Standard Race

Below is the flow for a typical NASCAR race from `scheduled` to `closed`.

<Image align="center" border={false} width="75% " src="https://files.readme.io/f5090e822b08c14d4e63c624a09a26e2dd31d3d11e134e877fff59333f745133-Game_Workflows_21.png" />

<br />

### Time-TBD

Below is the flow of a `time-tbd` race. Once this race reaches scheduled status it follows the Standard Race flow.

<Image align="center" border={false} width="75% " src="https://files.readme.io/400653f36ca544b688232dc75b25ed3e4cc789b2eecf6a4088c8d646c382161f-Game_Workflows_22.png" />

<br />

### Postponed

Below is the flow for a postponed race. Postponed races retain the same race ID throughout the lifecycle.

**Prior to race start:**

If a race is postponed *prior to* the start, the IDs assigned to the race will remain unchanged. The race will resume from where it was left off once a new date and time are established. As soon as these details are confirmed, the race `scheduled` attribute is updated to reflect the changes. The `start_time` attribute is adjusted post-race.

* Example Race: `6d88e04f-3da2-473d-a44b-8a0b38fe32cd`

**After race start:**

If a race is postponed *after* the start, the data transfers from `green` flag to `red` flag with a status of `inprogress` until NASCAR makes the decision to finish the race a different day and end track activities. At this point, the status updates from `inprogress` to `delayed`, with the `scheduled` time remaining. The IDs assigned to the race will remain unchanged.

When the race finishes the following day the `start_time` and `end_time` values are adjusted to be the tv window for the rest of the race.

* Example Race: `4daedbcd-f1c6-4bc1-9690-f85d1fd1af4a`

<Image border={false} src="https://files.readme.io/5e28effa9e7069a939f6a1ffdbbeab1daaa0126491fbe88d820c757e9b6897f7-Game_Workflows_24.png" />

<br />

### Canceled

Below is the flow for a race with a `canceled` status. A canceled race will remain in this status and will not transition to any other state. No race data resumes or completes for canceled races.

See race `0e524ac8-779e-4e22-8f10-f73c672c1a50` for an example of a canceled race.

<Image align="center" border={false} width="75% " src="https://files.readme.io/2a640360f45800f0f196d29549d9dc292fca9fae2566d48020ac281df334f070-Game_Workflows_25.png" />

<br />

***

## Race State Samples

Click the links below for sample data of Leaderboard feeds by race state.

* [scheduled](https://api-docs.sportradar.us/nascar/NASCAR_API_Scheduled_Samples.zip)
* [closed](https://api-docs.sportradar.us/nascar/NASCAR_API_Closed_Samples.zip)
* [canceled](https://api-docs.sportradar.us/nascar/NASCAR_API_Canceled_Samples.zip)

<br />

***

## Weekly Data Entry

<ul>
  <li><a href="#tabs-1">Monday</a></li>
  <li><a href="#tabs-2">Tuesday</a></li>
  <li><a href="#tabs-3">Thursday - Sunday</a></li>
</ul>

<div id="tabs-1">
  <h3>Monday</h3>
  <p>Previous week’s races’ status changed from complete to closed</p>
  <p>Drivers’ standings are confirmed</p>
  <p>Upcoming week’s races’ status changed from scheduled to initialized</p>
  <p>Confirm entry list for upcoming week’s races (continues until 1<sup>st</sup> practice)</p>
</div>

<div id="tabs-3">
  <h3>Tuesday</h3>
  <p>Update drivers, sponsors, teams (this is ongoing work)</p>
</div>

<div id="tabs-5">
  <h3>Thursday - Sunday</h3>
  <p>Monitoring of NASCAR-sourced incoming practice, qualifying, and race data as events occur</p>
  <p> </p>
</div>

<div id="tabs-8" />

<br />

<br />