Game Status Workflow

Intro

Every NCAA Women's Basketball (NCAAWB) game travels through various statuses in its lifecycle. Leverage the game status to inform on the appropriate endpoint to retrieve.

Game status is available in every Schedule and Game endpoint. To retrieve a game's initial status and schedule information it would be most appropriate to request the Schedule or Daily Schedule endpoints.

<game id="9d854ac4-f93e-429e-8163-b7dacfe59c43" status="closed" coverage="extended_boxscore" scheduled="2024-11-04T15:30:00Z" home_points="85" away_points="39" conference_game="false" home_team="10d8e1cc-4ce5-46d4-9caf-154b203768ed" away_team="876ceafd-2be8-4bd8-bc7e-57d063698f2a">
	<time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
	<venue id="c5e846e9-2860-4c55-8352-c3a4587afe27" name="Hank McCamish Pavilion" capacity="8600" address="965 Fowler Street" city="Atlanta" state="GA" zip="30332" country="USA">
		<location lat="33.780833" lng="-84.392778"/>
	</venue>
	<home name="Georgia Tech Yellow Jackets" alias="GT" id="10d8e1cc-4ce5-46d4-9caf-154b203768ed"></home>
	<away name="Winthrop Eagles" alias="WIN" id="876ceafd-2be8-4bd8-bc7e-57d063698f2a"></away>
</game>

{
  "games": [
    {
      "id": "9d854ac4-f93e-429e-8163-b7dacfe59c43",
      "status": "closed",
      "coverage": "extended_boxscore",
      "scheduled": "2024-11-04T15:30:00Z",
      "home_points": 85,
      "away_points": 39,
      "conference_game": false,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Eastern"
      },
      "venue": {
        "id": "c5e846e9-2860-4c55-8352-c3a4587afe27",
        "name": "Hank McCamish Pavilion",
        "capacity": 8600,
        "address": "965 Fowler Street",
        "city": "Atlanta",
        "state": "GA",
        "zip": "30332",
        "country": "USA",
        "location": {
          "lat": "33.780833",
          "lng": "-84.392778"
        }
      },
      "home": {
        "name": "Georgia Tech Yellow Jackets",
        "alias": "GT",
        "id": "10d8e1cc-4ce5-46d4-9caf-154b203768ed"
      },
      "away": {
        "name": "Winthrop Eagles",
        "alias": "WIN",
        "id": "876ceafd-2be8-4bd8-bc7e-57d063698f2a"
      }
    }
  ]
}

Coverage Levels

We cover all games involving a Division I team at a Full or Extended Boxscore coverage tier.

Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team- and player-level data in near real time.

Full coverage is available for:

All games featuring an AP Top 25 team
All "Power Five" (ACC, B1G, Big 12, Big East, SEC) Conference Tournament games
All Division I March Madness Tournament games

Extended Boxscore – We provide scores and time remaining, in a timely manner, as the game progresses. We provide team- and player-level data for the game within 120 minutes of the official results being posted. Extended Boxscore coverage is available for any game involving a Division I program, not covered via our full coverage offering.

🏀
Coverage Note
Coverage levels are subject to change up to the scheduled game start time. Changes are usually due to resource availability or possible broadcast and technical difficulties.

Game Status Definitions

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

scheduled - The game is scheduled to occur.
created – The game has been created and we have begun logging information.
inprogress – The game is in progress.
halftime - The game is currently at halftime.
complete – The game is over, but stat validation is not complete.
closed – The game is over and the stats have been validated.
cancelled – The game has been cancelled. No makeup game will be played as a result.
delayed – The start of the game is currently delayed or the game has gone from in progress to delayed for some reason.
postponed – The game has been postponed, to be made up at another day and time. Once the makeup game is announced, a new game and ID will be created and scheduled on the announced makeup date.
time-tbd – The game has been scheduled, but a time has yet to be announced.
if-necessary – The game will be scheduled if it is required.
unnecessary – The series game was scheduled to occur, but will not take place due to one team clinching the series early.
forfeited – The game has been forfeited by one of the scheduled teams and is considered complete.

Game Workflows

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

Standard Game

Below is the flow for a typical NCAAWB game from scheduled to closed.

Standard Game Flowscheduled to closed, with what each move signals

Pregame

scheduledThe game is scheduled to occur, with a determined date and time. Status appears in every schedule and game feed.

Preload

createdGame data (rosters, officials, and more) pre-loads, and each team's roster is applied to the game. Starters (starters="true") display 5-45 minutes before the start of the game; player participation (played="true") updates for starters before the game, and for other players as they appear in the game.

Jump ball

inprogressSet after the jump ball. Poll the game feeds for realtime updates; game feeds can reach inprogress before the schedule feeds, whose status updates on a timer.

Break

halftimeThe game is at halftime.

Second half

inprogressPlay resumes at the beginning of the second half.

Final score

completeThe game is over and the score is correct; all other game statistics are reviewed and verified in the post-game verification process.

Validated

closedAll stats are validated. Post-game verification covers player and team statistics, and game attendance and duration. Adjustments can still land after closed; follow the Daily Change Log.

complete marks the game over with the score correct; closed marks every stat validated.

🕑
Time from Complete to Closed
It takes an average of 90 minutes for a College Basketball game to move from Complete to Closed.

Time-TBD

Below is the flow of a time-tbd game. Once this game reaches scheduled status it follows the Standard Game flow.

Time TBDa placeholder status that resolves to scheduled

No time yettime-tbdThe game has been scheduled, but a time has yet to be announced.

ResolvedscheduledA determined date and time are announced, and the status appears in every schedule and game feed.

Once the game reaches scheduled, it follows the Standard Game flow.

Delayed

Below is the flow of a delayed game.

A game can be delayed before it starts or during play. Once a delayed game moves to inprogress it follows the Standard Game flow.

Delayed Gamea hold before or during play; the game keeps its ID

Held upscheduledinprogressA delay can begin before or during a game: the start of a scheduled game is held up, or a game already in progress is interrupted.

On holddelayedThe game is delayed. It keeps its game ID and stays on the schedule and game feeds in delayed status; keep polling for the next status change.

ResumedinprogressPlay begins, or picks up where it left off, under the same game ID, and the game continues through the Standard Game flow.

Not playedpostponedIf the game cannot continue that day, it moves to postponed. Once the makeup game is announced, a new game and ID are created and scheduled on the announced makeup date.

Delayed is a holding status, not an end state: the game returns to inprogress under the same game ID or moves on to postponed.

Postponed

Below is the flow of a postponed game.

Once a new game is created in scheduled status, it follows the Standard Game flow.

Postponed Gamethe makeup arrives as a new game ID

On the books

scheduledThe game is scheduled to occur, with a determined date and time. Status appears in every schedule and game feed.

Pushed

postponedThe game will be made up at another day and time. Once the makeup game is announced, a new game and ID are created and scheduled on the announced makeup date; request the schedule feeds regularly to identify makeup games.

Rescheduled

scheduledA new game, with a new game ID, is created in scheduled status when a determined date and time are announced. The postponed and rescheduled game IDs are not linked within the API.

The original entry keeps the postponed status; the makeup game follows the Standard Game flow under its new ID.

Cancelled

Below is the flow of a cancelled game.

A cancelled game will remain in cancelled status. See game 4f2c4ea4-550e-4c1d-8054-6bf0e6c3790c as an example.

Cancelled Gamea terminal status with no makeup game

On the books

scheduledThe game is scheduled to occur, with a determined date and time. Status appears in every schedule and game feed.

Called off

cancelledThe game has been cancelled, and no makeup game will be played.

Cancelled is terminal: the game remains in cancelled status.

Forfeited

Below is the flow of a forfeited game.

See game 2af28de9-6fdf-4d01-ba28-5fdeb2e1d2ae as an example.

Forfeited Gamea pregame ruling that counts as a completed game

On the books

scheduledThe game is scheduled to occur, with a determined date and time. Status appears in every schedule and game feed.

Preload

createdGame data (rosters, officials, and more) pre-loads in preparation for the game.

Ruling

forfeitedThe game has been forfeited by one of the scheduled teams, and no makeup game will be played. The winning team is indicated with forfeit_winner="true".

Forfeited is terminal and the game is considered complete.

Game State Samples

Click the links below for sample data of Game feeds by game state.

inprogress

🏀
Simulations
We would also suggest using our Simulations to view each of these game states and test your integration.

Weekly Data Entry

This section provides important NCAAWB data update timings for schedules, statistics, rankings, and more.

The core data entry workflow runs every day of the week:

Final game times and coverage levels set for the day's games (10am CT)
Game stats validated and moved to closed status (on average, 90 minutes after the game goes final)

Day-specific additions:

Monday: Weekly AP and USA Today Top 25 Polls created (5pm CT); initial coverage levels set for the week's games, Monday through Sunday (5pm CT, levels subject to change); TV broadcast information updated (end of day)
Monday through Wednesday: Seasonal stats validation (all day)

Important Dates & Timings

The NCAA Women's Basketball schedule becomes available by late October.
All game times and dates are monitored and validated throughout the season and confirmed the day of the game.
Coverage levels are set prior to the start of each week and re-affirmed each morning.