Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Game Status Workflow

Intro

A WNBA game travels through many 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="a0c81135-419b-46e1-b1e6-5f9fd9d56208" status="closed" coverage="full" scheduled="2024-05-14T23:00:00Z" home_points="80" away_points="85" track_on_court="true" sr_id="sr:match:46601521" reference="1022400001" cc_cup="false" home_team="5c0d47fe-8539-47b0-9f36-d0b3609ca89b" away_team="08ed8274-e29f-4248-bc2e-83cc8ed18d75">
	<time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
	<venue id="84776b5f-b41b-4356-a5ed-3a2c28ab2597" name="St. Elizabeths East Entertainment and Sports Arena" capacity="4200" address="1100 Oak Street SE" city="Washington" state="DC" zip="20032" country="USA" sr_id="sr:venue:35680">
		<location lat="38.846767" lng="-76.991422"/>
	</venue>
	<home name="Washington Mystics" alias="WAS" id="5c0d47fe-8539-47b0-9f36-d0b3609ca89b" sr_id="sr:team:3454"></home>
	<away name="New York Liberty" alias="NYL" id="08ed8274-e29f-4248-bc2e-83cc8ed18d75" sr_id="sr:team:3446"></away>
{
"games": [
    {
      "id": "a0c81135-419b-46e1-b1e6-5f9fd9d56208",
      "status": "closed",
      "coverage": "full",
      "scheduled": "2024-05-14T23:00:00Z",
      "home_points": 80,
      "away_points": 85,
      "track_on_court": true,
      "sr_id": "sr:match:46601521",
      "reference": "1022400001",
      "cc_cup": false,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Eastern"
      },
      "venue": {
        "id": "84776b5f-b41b-4356-a5ed-3a2c28ab2597",
        "name": "St. Elizabeths East Entertainment and Sports Arena",
        "capacity": 4200,
        "address": "1100 Oak Street SE",
        "city": "Washington",
        "state": "DC",
        "zip": "20032",
        "country": "USA",
        "sr_id": "sr:venue:35680",
        "location": {
          "lat": "38.846767",
          "lng": "-76.991422"
        }
      },
      "broadcasts": [
        {
          "network": "ESPN3",
          "type": "Internet"
        },
        {
          "network": "Monumental",
          "type": "Internet",
          "locale": "Home"
        },
        {
          "network": "WWOR",
          "type": "TV",
          "locale": "Away"
        }
      ],
      "home": {
        "name": "Washington Mystics",
        "alias": "WAS",
        "id": "5c0d47fe-8539-47b0-9f36-d0b3609ca89b",
        "sr_id": "sr:team:3454"
      },
      "away": {
        "name": "New York Liberty",
        "alias": "NYL",
        "id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
        "sr_id": "sr:team:3446"
      }
    }
  ]
}


Coverage Levels

We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.

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 regular and post-season games as well as those pre-season games available live via a broadcast.

Extended Boxscore – We provide scores, time remaining, and team leaders (assists, points, and rebounds), in a timely manner, as the game progresses. We provide team- and player-level data for the game within 30 minutes of the official results being posted. Extended Boxscore coverage is available for any pre-season game not available via a reliable broadcast.

🏀

Preseason Coverage Note:

Preseason coverage of WNBA games may vary. Some games may be extended boxscore coverage due to on-venue data-entry being unavailable.

API data latency will vary compared to regular season games. Preseason games often serve as a testing ground, resulting in changes and adjustments to data collection methods. As a result, data updates may not be as timely or consistent as the regular season.



Game Status Definitions

Below are each of the valid game statuses you can expect to see in the WNBA 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.


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 WNBA game from scheduled 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.



Postponed

Below is the flow of a postponed game.

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



Suspended

Below is the flow of a suspended game.

Once a suspended game moves back to inprogress it follows the Standard Game flow.



Cancelled

Below is the flow of a cancelled game.

A cancelled game will remain in cancelled status. See game 5126d64c-1865-4ef6-87ce-e64ec9581e1b as an example.



Game State Samples

Click the links below to view sample data for NBA game feeds, which closely mirror the structure of WNBA game feeds across different game states.

🏀

Simulations

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