Game Status Workflow

Intro

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

{
"games": [
    {
      "id": "48f3a2b5-5d2a-4525-99d1-e93bcdf4184a",
      "status": "closed",
      "coverage": "full",
      "scheduled": "2025-10-25T00:00:00+00:00",
      "home_points": 0,
      "away_points": 7,
      "track_on_court": true,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Arizona"
      },
      "venue": {
        "id": "c76914a3-7d54-4d6e-be85-cd6ccc69da47",
        "name": "Addition Financial Arena",
        "capacity": 9465,
        "address": "12777 Gemini Boulevard N",
        "city": "Orlando",
        "state": "FL",
        "zip": "32816",
        "country": "USA",
        "location": {
          "lat": "28.607225",
          "lng": "-81.1973669"
        }
      },
      "home": {
        "name": "New York Team 2",
        "alias": "NYR",
        "id": "2c0d090b-3429-4ae0-8c44-78948867f825"
      },
      "away": {
        "name": "Chicago Team 1",
        "alias": "CHI",
        "id": "1cfb6e14-69be-4a8d-a483-7b522b5b80c5"
      }
    },
    {
      "id": "087d649a-1609-4047-8bed-304bdf48bcb4",
      "status": "inprogress",
      "title": "New Game",
      "coverage": "full",
      "scheduled": "2025-10-27T20:00:00+00:00",
      "track_on_court": true,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Arizona"
      },
      "venue": {
        "id": "c76914a3-7d54-4d6e-be85-cd6ccc69da47",
        "name": "Addition Financial Arena",
        "capacity": 9465,
        "address": "12777 Gemini Boulevard N",
        "city": "Orlando",
        "state": "FL",
        "zip": "32816",
        "country": "USA",
        "location": {
          "lat": "28.607225",
          "lng": "-81.1973669"
        }
      },
      "home": {
        "name": "New York Team 2",
        "alias": "NYR",
        "id": "2c0d090b-3429-4ae0-8c44-78948867f825"
      },
      "away": {
        "name": "Chicago Team 1",
        "alias": "CHI",
        "id": "1cfb6e14-69be-4a8d-a483-7b522b5b80c5"
      }
    },
    {
      "id": "f84f19a9-572c-434c-a9cb-3295a841625a",
      "status": "inprogress",
      "title": "Game",
      "coverage": "full",
      "scheduled": "2025-10-27T20:00:00+00:00",
      "track_on_court": true,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Arizona"
      },
      "venue": {
        "id": "c76914a3-7d54-4d6e-be85-cd6ccc69da47",
        "name": "Addition Financial Arena",
        "capacity": 9465,
        "address": "12777 Gemini Boulevard N",
        "city": "Orlando",
        "state": "FL",
        "zip": "32816",
        "country": "USA",
        "location": {
          "lat": "28.607225",
          "lng": "-81.1973669"
        }
      },
      "home": {
        "name": "New York Team 2",
        "alias": "NYR",
        "id": "2c0d090b-3429-4ae0-8c44-78948867f825"
      },
      "away": {
        "name": "Chicago Team 1",
        "alias": "CHI",
        "id": "1cfb6e14-69be-4a8d-a483-7b522b5b80c5"
      }
    },
    {
      "id": "b1ce6d7c-29a6-43b3-876e-3b6033502dfe",
      "status": "inprogress",
      "title": "TEST",
      "coverage": "full",
      "scheduled": "2025-10-27T22:00:00+00:00",
      "track_on_court": true,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Arizona"
      },
      "venue": {
        "id": "c76914a3-7d54-4d6e-be85-cd6ccc69da47",
        "name": "Addition Financial Arena",
        "capacity": 9465,
        "address": "12777 Gemini Boulevard N",
        "city": "Orlando",
        "state": "FL",
        "zip": "32816",
        "country": "USA",
        "location": {
          "lat": "28.607225",
          "lng": "-81.1973669"
        }
      },
      "home": {
        "name": "New York Team 2",
        "alias": "NYR",
        "id": "2c0d090b-3429-4ae0-8c44-78948867f825"
      },
      "away": {
        "name": "Chicago Team 1",
        "alias": "CHI",
        "id": "1cfb6e14-69be-4a8d-a483-7b522b5b80c5"
      }
    }
  ]
}

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.

Game Status Definitions

Below are each of the valid game statuses in the Unrivaled 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. Although Unrivaled uses a 3-on-3 format, halftime appears in the API the same way it does for 5-on-5 basketball products.
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.

Note: Unrivaled does not use conditional postseason statuses such as if-necessary or unnecessary. These appear in some other basketball products but are not applicable to Unrivaled's single-elimination format during playoffs and tournaments.

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 Unrivaled 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 this NBA game (5126d64c-1865-4ef6-87ce-e64ec9581e1b) as an example, which follows a structure similar to that of the Unrivaled API.

Game Samples

Unrivaled Samples for Closed Games

WNBA samples

Although these samples are for the WNBA, they can still be extremely helpful when working with Unrivaled. Both APIs share the same core basketball structure, game lifecycle, event progression, and feed architecture. The primary differences involve Unrivaled-specific rules, such as 3-on-3 play, weighted free throws, and the Elam Ending, but the overall data model and feed patterns remain consistent.

🏀
Simulations
While there are no Unrivaled-specific simulations available yet, you can use our **Simulations ** for WNBA, which follow a similar game structure. These are helpful for viewing each game state and testing your integration.