Unrivaled FAQs

Coverage

How is each Unrivaled competition covered?

All Unrivaled competitions receive full real-time coverage, including complete play-by-play.

The only exception is forfeited games. These are downgraded to extended_boxscore coverage and include final scores only (no play-by-play or stats).

Integration

Are simulations available for this API?

No — simulations are not currently available for Unrivaled. If you need sample data, we recommend using the completed season as a reference.

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120

The TTL may adjust when an event is live for some game-centric endpoints. This information is available for each endpoint on our developer portal.

Game Statuses

What game statuses can I expect to see and what are their definitions?

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. You should request the scheduled feed(s) regularly to identify the re-scheduled makeup game(s).
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.

Player Statuses

What player statuses can I expect to see?

ACT – The player is on the team’s active roster
SUS – The player is suspended
IR – The player is on injured reserve
NWT – The player is no longer with the team
FA – Free Agent
RET – Retired
DUP – Duplicate

Player Positions

What player positions can I expect to see?

NA
C
C-F
F
F-C
F-G
G
G-F

Injuries

What player injury statuses can I expect to see?

Unknown
Day to Day
Out
Out for Season
Out Indefinitely

<injuries>
    <injury id="1805a44b-1b17-42e7-a26a-5270882d4248" comment="McLaughlin did not play in Wednesday's (Nov.8) game against New Orleans." 
		desc="Knee" status="Day To Day" start_date="2023-11-07" update_date="2023-11-08"/>
</injuries>

"injuries": [
  {
    "id": "1805a44b-1b17-42e7-a26a-5270882d4248",
    "comment": "McLaughlin did not play in Wednesday's (Nov.8) game against New Orleans.",
    "desc": "Knee",
    "status": "Day To Day",
    "start_date": "2023-11-07",
    "update_date": "2023-11-08"
  }
]

What player injury statuses can I expect to see?

Unknown
Day to Day
Out
Out for Season
Out Indefinitely

<injuries>
    <injury id="1805a44b-1b17-42e7-a26a-5270882d4248" comment="McLaughlin did not play in Wednesday's (Nov.8) game against New Orleans." 
		desc="Knee" status="Day To Day" start_date="2023-11-07" update_date="2023-11-08"/>
</injuries>

"injuries": [
  {
    "id": "1805a44b-1b17-42e7-a26a-5270882d4248",
    "comment": "McLaughlin did not play in Wednesday's (Nov.8) game against New Orleans.",
    "desc": "Knee",
    "status": "Day To Day",
    "start_date": "2023-11-07",
    "update_date": "2023-11-08"
  }
]

Transactions

What are the valid `transaction_code` and `transaction_type` values?

ACT - Activated
MIN - Assigned to Minors
CL - Claimed
CEXP - Contract Expired
CEXT - Contract Extension
DEC - Deceased
FA - Declared Free Agency
DRA - Drafted
SUS - League Suspension
ABS - Leave of Absence
NWT - Not With Team
TRAN - Other Transaction
INACT - Placed on Inactive List
RSGN - Re-Signed
REC - Recalled from Minors
RSUS - Reinstated from Suspension
REL - Released
RET - Retired
EDRA - Selected in Expansion Draft
SGN - Signed
10D - Signed to 10-Day Contract
10D2 - Signed to Second 10-Day Contract
TSUS - Team Suspension
TRD - Traded
WA - Waived

Shot Types

What shot type descriptions can I expect to see in the feeds?

Jump Shot (This is the only shot type for 3-point attempts)

bank
driving
driving bank
driving floating
driving floating bank
turnaround
turnaround bank
turnaround fadeaway
turnaround fadeaway bank
floating
fadeaway
fadeaway bank
stepback
stepback bank
pullup
pullup bank
running
running pullup

Layup

alley-oop
cutting
cutting finger roll
driving
driving reverse
driving finger roll
finger roll
putback
reverse
running
running reverse
running finger roll
running alley-oop
tip

Dunk

alley-oop
tip
driving
driving reverse
putback
running
reverse
running reverse
running alley-oop
cutting

Tip Shot

Hook

bank
driving
driving bank
turnaround
turnaround bank

Event Types

What are the valid events types tracked in the Play-by-Play endpoint?

challengereview - Instant replay (challenge: outcome)
challengetimeout - team name challenge timeout
clearpathfoul - charged_to clear path foul (drawn_by draws the foul)
deadball - given_to rebound (deadball)
defaultviolation - charged_to violation
defensivegoaltending - charged_to defensive goaltending violation
delay - charged_to delay of game violation
doublelane - charged_to double lane violation
ejection - given_to ejected from the game (ejection_type)
endperiod - End of nth period/half
flagrantone - charged_to flagrant 1 (drawn_by draws the foul)
flagranttwo - charged_to flagrant 2 (drawn_by draws the foul)
freethrowmade - taken_by makes free_throw_type free throw attempt
freethrowmiss - taken_by misses free_throw_type free throw attempt (charged_to lane_violation)
jumpball - Jump ball reason. possessor vs challenger (possession gains possession)
kickball - charged_to kicked ball violation
lane - charged_to lane violation
lineupchange - team_name lineup change (players)
lineupchangeone - team_name lineup change (player)
lineupchangethree - team_name lineup change (players)
offensivefoul - charged_to offensive foul (foul_type_desc) (drawn_by draws the foul)
officialtimeout - Official timeout
openinbound - Open inbound team_name
opentip - Jump ball. home vs away (possession gains possession)
periodstart - Start of nth period/half
personalfoul - charged_to personal foul (foul_type_desc) (drawn_by draws the foul)
possession - possession gain possession
rebound - given_to offensive/defensive rebound
requestreview - Instant replay (request)
resettimeout - team_name reset timeout
review - Play review (reason, outcome)
shootingfoul - charged_to shooting foul (drawn_by draws the foul)
stoppage - Stoppage (reason)
teamtimeout - team_name duration second timeout
technicalfoul - charged_to technical foul (foul_type_desc)
technicalfoulnonunsportsmanlike - charged_to technical foul (foul_type_desc)
threepointmade - taken_by makes three point shot_type_desc shot_type (assisted_by assists)
threepointmiss - taken_by misses three point shot_type_desc shot_type
turnover - charged_to turnover (turnover type_desc)
tvtimeout - TV Timeout
twopointmade - taken_by makes two point shot_type_desc shot_type (assisted_by assists)
twopointmiss - taken_by misses two point shot_type_desc shot_type

<event id="b2979d2c-f1e5-4871-bd19-570b14102491" clock="11:42" updated="2023-10-25T01:55:30Z" 
wall_clock="2023-10-24T23:36:13Z" sequence="1698190573000" home_points="0" away_points="2" 
clock_decimal="11:42" number="7" event_type="twopointmade">
    <description>Anthony Davis makes two point dunk (D'Angelo Russell assists)</description>

<event id="fa7ebeaf-b05f-47f1-a7ce-f5976048d07c" clock="9:16" updated="2023-10-25T01:55:32Z" 
wall_clock="2023-10-24T23:39:22Z" sequence="1698190762600" home_points="9" away_points="10" 
clock_decimal="9:16" number="30" event_type="freethrowmiss" attempt="1 of 1">
  <description>Nikola Jokic misses regular free throw 1 of 1</description>

<event id="3a67d3c2-3dfb-4c34-bf77-6f5db86c548e" clock="3:52" updated="2023-10-25T01:55:50Z" 
wall_clock="2023-10-25T00:22:22Z" sequence="1698193342400" home_points="54" away_points="42" 
clock_decimal="3:52" number="268" event_type="personalfoul">
    <description>Rui Hachimura personal foul (Loose ball) (Nikola Jokic draws the foul)</description>

Standings & Rankings

What are the valid `clinched` playoff values for a team in the Rankings endpoint?

Here is a list of the clinched values and their definitions:

conference – The team has clinched the best record home court advantage for the playoffs
division – The team has clinched their division*
division_playoff_berth – The team has clinched their division and a playoff berth*
eliminated – The team has been eliminated from playoff contention
playoff_berth – The team has clinched a playoff berth
play_in_berth – The team has clinched at least the play-in game
Divisions are not currently used in the WNBA

<conference id="092510cf-3285-48bb-b831-40ac3608ca36" name="EASTERN CONFERENCE" alias="EASTERN-W">
  <team id="08ed8274-e29f-4248-bc2e-83cc8ed18d75" name="Liberty" market="New York" sr_id="sr:team:3446">
    <rank conference="1" clinched="playoff_berth"/>
  </team>
  <team id="a015b02d-845c-40c1-8ef4-844984f47e4d" name="Sun" market="Connecticut" sr_id="sr:team:35547">
    <rank conference="2" clinched="playoff_berth"/>
  </team>
  <team id="f073a15f-0486-4179-b0a3-dfd0294eb595" name="Fever" market="Indiana" sr_id="sr:team:3452">
    <rank conference="3" clinched="playoff_berth"/>
  </team>
  <team id="5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4" name="Dream" market="Atlanta" sr_id="sr:team:35545">
    <rank conference="4" clinched="playoff_berth"/>
  </team>
  <team id="5c0d47fe-8539-47b0-9f36-d0b3609ca89b" name="Mystics" market="Washington" sr_id="sr:team:3454">
    <rank conference="5" clinched="eliminated"/>
  </team>
  <team id="3c409388-ab73-4c7f-953d-3a71062240f6" name="Sky" market="Chicago" sr_id="sr:team:35546">
    <rank conference="6" clinched="eliminated"/>
  </team>
</conference>

{
  "id": "092510cf-3285-48bb-b831-40ac3608ca36",
  "name": "EASTERN CONFERENCE",
  "alias": "EASTERN-W",
  "teams": [
    {
      "id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
      "name": "Liberty",
      "market": "New York",
      "sr_id": "sr:team:3446",
      "rank": {
        "conference": 1,
        "clinched": "playoff_berth"
      }
    },
    {
      "id": "a015b02d-845c-40c1-8ef4-844984f47e4d",
      "name": "Sun",
      "market": "Connecticut",
      "sr_id": "sr:team:35547",
      "rank": {
        "conference": 2,
        "clinched": "playoff_berth"
      }
    },
    {
      "id": "f073a15f-0486-4179-b0a3-dfd0294eb595",
      "name": "Fever",
      "market": "Indiana",
      "sr_id": "sr:team:3452",
      "rank": {
        "conference": 3,
        "clinched": "playoff_berth"
      }
    },
    {
      "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
      "name": "Dream",
      "market": "Atlanta",
      "sr_id": "sr:team:35545",
      "rank": {
        "conference": 4,
        "clinched": "playoff_berth"
      }
    },
    {
      "id": "5c0d47fe-8539-47b0-9f36-d0b3609ca89b",
      "name": "Mystics",
      "market": "Washington",
      "sr_id": "sr:team:3454",
      "rank": {
        "conference": 5,
        "clinched": "eliminated"
      }
    },
    {
      "id": "3c409388-ab73-4c7f-953d-3a71062240f6",
      "name": "Sky",
      "market": "Chicago",
      "sr_id": "sr:team:35546",
      "rank": {
        "conference": 6,
        "clinched": "eliminated"
      }
    }
  ]
},

Court Dimensions

What is the scale of the X Y coordinates?

The court we use is 1128 by 600. The scale is in inches.

What x/y vertices define action areas in the x/y coordinate graph?

A list of areas is included below. Note that these vertices are for the left side of the court. For the right side, we use the following calculation, where length=1128 and width=600:

right-court-point = (length - x, width - y)
left_basket=[63, 300]
right_basket=[1065, 300]

Areas:

underbasket: [ 48, 247 ], [ 64, 247 ], [ 80, 250 ], [ 94, 258 ], [ 105, 271 ], [ 111, 287 ], [ 111, 303 ], [ 105, 319 ], [ 94, 332 ], [ 80, 340 ], [ 64, 343 ], [ 48, 343 ]
inthepaint: [ 0, 198 ], [ 228, 198 ], [ 228, 390 ], [ 0, 390 ]
insiderightwing: [ 0, 36 ], [ 93, 36 ], [ 74, 198 ], [ 0, 198 ]
insideright: [ 93, 36 ], [ 135, 39 ], [ 175, 54 ], [ 216, 78 ], [ 243, 100 ], [ 271, 129 ], [ 282,145 ], [ 228, 198 ], [ 228, 198 ], [ 74, 198 ]
insidecenter: [ 228, 198 ], [ 282, 145 ], [ 302, 179 ], [ 317, 216 ], [ 326, 255 ], [ 329, 294 ], [ 326, 334 ], [ 317, 373 ], [ 303, 410 ], [ 283, 444 ], [ 228, 390 ]
insideleft: [228, 390 ], [ 228, 390 ], [ 283, 444 ], [ 271, 460 ], [ 244, 490 ], [ 216, 512 ], [ 175, 536 ], [ 135, 551 ], [ 93, 554 ], [ 74, 390 ]
insideleftwing: [ 0, 554 ], [ 93, 554 ], [ 74, 390 ], [ 0, 390 ]
outsiderightwing: [ 0, 0 ], [ 97, 0] , [ 93, 36 ], [ 0, 36 ]
outsideright: [ 97, 0 ], [ 432, 0 ], [ 282, 145 ], [ 271, 129 ], [ 243, 100 ], [ 216, 78 ], [ 175, 54 ], [ 135, 39 ], [ 93, 36 ]
outsidecenter: [ 282, 145 ], [ 432, 0 ], [ 432, 590 ], [ 283, 444 ], [ 303, 410 ], [ 317, 373 ], [ 326, 334 ], [ 329, 294 ], [ 326, 255 ], [ 317, 216 ], [ 302, 179 ]
outsideleft: [ 97, 590 ], [ 432, 590 ], [ 283, 444 ], [ 271, 460 ], [ 244, 490 ], [ 216, 512 ], [ 175, 536 ], [ 135, 551 ], [ 93, 554 ]
outsideleftwing: [ 0, 590 ], [ 97, 590 ], [ 93, 554 ], [ 0, 554 ]
backcourt: [ 432, 0 ], [ 864, 0 ], [ 864, 590 ], [ 432, 590 ]

Play-by-Play Types

What are the valid turnover type descriptions I can expect to see?

Traveling
Bad Pass
Lost Ball
Carrying
Palming
Out of Bounds
- Lost Ball
- Step
- Bad Pass
Double Dribble
Offensive Goaltending
3-second violation
5-second violation
8-second violation
10-second violation
Back Court Violation
Shot Clock Violation
Lane Violation
Illegal Assist
Illegal Screen
Turnover
Offensive Foul
Discontinue Dribble

<event id="5f7be1b5-b4a2-4da9-a0d7-053f24dc8345" clock="2:14" updated="2023-10-25T01:55:52Z" 
wall_clock="2023-10-25T00:25:28Z" sequence="1698193528300" home_points="58" away_points="48" 
clock_decimal="2:14" number="289" event_type="turnover" turnover_type="Bad Pass">
    <description>Austin Reaves turnover (bad pass) (Michael Porter Jr. steals)</description>

{
    "id": "f359da78-1de6-493d-a868-a1fa9d084edd",
    "clock": "8:36",
    "updated": "2023-10-25T01:55:59Z",
    "description": "Nuggets turnover (shot clock violation)",
    "wall_clock": "2023-10-25T00:58:14Z",
    "sequence": 1698195494100,
    "home_points": 70,
    "away_points": 62,
    "clock_decimal": "8:36",
    "number": 372,
    "event_type": "turnover",
    "turnover_type": "Shot Clock Violation",
    "qualifiers": [
        {
            "qualifier": "team"
        }
    ],

What are the valid stoppage reasons I can expect to see?

Out of Bounds
Equipment Malfunction
Blood Rule
Court Cleanup
Injury
Other

{
    "id": "c4febe02-deb8-4855-867e-ee91e1d26147",
    "clock": "00:09",
    "updated": "2023-10-25T01:56:08Z",
    "description": "Stoppage (Out of bounds)",
    "wall_clock": "2023-10-25T01:17:27Z",
    "sequence": 1698196647900,
    "home_points": 87,
    "away_points": 80,
    "clock_decimal": "00:09.80",
    "number": 486,
    "event_type": "stoppage",
    "on_court": {
        "home": {
            "name": "Nuggets",

What are the valid free throw types I can expect to see?

regular
technical
flagrant
clear Path
weighted

<freethrow made="true" free_throw_type="regular" points="1">

Foul Types

What are the valid foul type descriptions I can expect to see?

Charge
Off the Ball
Block
Take
Double
Shooting
Clear Path
Loose Ball
Blocking
Player Control
Shooting block
Elbowing
Punching
Flagrant One
Flagrant Two
Away from Play
Unsportsmanlike Conduct
Rim Hanging
Delay of Game
Taunting
Indirect
Inbound
Defensive Three Second
Flopping

What ejection types can I expect to see?

Technical
Second Technical
Second Flagrant Type 1
Flagrant Type 2
Other

Scoring

When are scores added to the schedule feeds?

Final scores are added to the schedule feeds when the game status changes to completed.

Schedules

How do I pull in schedule data for future games in which teams are not yet known?

This API features a TBD team used for every entry in to-be-determined matchups. This virtual team will have its own unique ID specific to this API.

Find the TBD team in the Teams endpoint.

<team id="64577946-68a2-4339-801d-7784df45cf78" name="TBD" alias="TBD" market="Team"/>

The matchups will appear as below in the Schedule endpoints.

<series id="0f81bb4d-1d0c-4a3b-82de-507534154095" title="NBA Finals - TBD vs TBD" round="4" start_date="2024-06-06" status="scheduled">
  <games>
  <game id="342f103b-0fd7-47ac-a84d-1391e3605e96" status="time-tbd" title="Game 1" coverage="full" scheduled="2024-06-06T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
      </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="71d8d5fc-6836-43c1-85a0-61a828296a06" status="time-tbd" title="Game 2" coverage="full" scheduled="2024-06-09T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="50b170b9-37e2-47d0-b517-e56ebb960cba" status="time-tbd" title="Game 3" coverage="full" scheduled="2024-06-12T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="8e94445c-c223-4a49-a759-0b651e440b95" status="time-tbd" title="Game 4" coverage="full" scheduled="2024-06-14T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="aaa3ddb3-dd1b-459e-a686-d2bfc4408881" status="if-necessary" title="Game 5 (if necessary)" coverage="full" scheduled="2024-06-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="7c16f1ec-6629-4675-aaaa-2a31835862a6" status="if-necessary" title="Game 6 (if necessary)" coverage="full" scheduled="2024-06-20T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="09129676-2320-4151-976d-713ea785d97b" status="if-necessary" title="Game 7 (if necessary)" coverage="full" scheduled="2024-06-23T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
</games>
</series>

"series": [
  {
    "id": "0f81bb4d-1d0c-4a3b-82de-507534154095",
    "title": "NBA Finals - TBD vs TBD",
    "round": 4,
    "start_date": "2024-06-06",
    "status": "scheduled",
    "participants": [],
    "games": [
      {
        "id": "342f103b-0fd7-47ac-a84d-1391e3605e96",
        "status": "time-tbd",
        "title": "Game 1",
        "coverage": "full",
        "scheduled": "2024-06-06T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "71d8d5fc-6836-43c1-85a0-61a828296a06",
        "status": "time-tbd",
        "title": "Game 2",
        "coverage": "full",
        "scheduled": "2024-06-09T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "50b170b9-37e2-47d0-b517-e56ebb960cba",
        "status": "time-tbd",
        "title": "Game 3",
        "coverage": "full",
        "scheduled": "2024-06-12T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "8e94445c-c223-4a49-a759-0b651e440b95",
        "status": "time-tbd",
        "title": "Game 4",
        "coverage": "full",
        "scheduled": "2024-06-14T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "aaa3ddb3-dd1b-459e-a686-d2bfc4408881",
        "status": "if-necessary",
        "title": "Game 5 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-17T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "7c16f1ec-6629-4675-aaaa-2a31835862a6",
        "status": "if-necessary",
        "title": "Game 6 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-20T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "09129676-2320-4151-976d-713ea785d97b",
        "status": "if-necessary",
        "title": "Game 7 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-23T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      }
    ]
  },

Make note of the status attribute to determine whether the time of the game is known. A status of time-tbd indicates the game has been scheduled, but a time has yet to be announced. A status of scheduled indicates the game time is known.

🙋
More questions?
Reach out to [email protected] for further assistance.

Categories

Coverage

How is each Unrivaled competition covered?

Integration

Are simulations available for this API?

What format are date fields presented in?

How do I locate the TTL (Time to Live)/cache on an API endpoint?

Game Statuses

What game statuses can I expect to see and what are their definitions?

Player Statuses

What player statuses can I expect to see?

Player Positions

What player positions can I expect to see?

Injuries

What player injury statuses can I expect to see?

What player injury statuses can I expect to see?

Transactions

What are the valid transaction_code and transaction_type values?

Shot Types

What shot type descriptions can I expect to see in the feeds?

Event Types

What are the valid events types tracked in the Play-by-Play endpoint?

Standings & Rankings

What are the valid clinched playoff values for a team in the Rankings endpoint?

Court Dimensions

What is the scale of the X Y coordinates?

What x/y vertices define action areas in the x/y coordinate graph?

Play-by-Play Types

What are the valid turnover type descriptions I can expect to see?

What are the valid stoppage reasons I can expect to see?

What are the valid free throw types I can expect to see?

Foul Types

What are the valid foul type descriptions I can expect to see?

What ejection types can I expect to see?

Scoring

When are scores added to the schedule feeds?

Schedules

How do I pull in schedule data for future games in which teams are not yet known?

More questions?

What are the valid `transaction_code` and `transaction_type` values?

What are the valid `clinched` playoff values for a team in the Rankings endpoint?