Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs
Coverage MatrixDocumentationChange LogLog InContact Us

Unrivaled FAQs

Browse by category below. Select any group or question to jump straight to it. Use your browser's find (Ctrl/Cmd + F) to search the page.

Table of Contents

Getting Started

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


How does the Unrivaled API differ from the WNBA API?

See our Key Data Differences section for Unrivaled-specific data.


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.


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.



Back to top ↑

Game Data

Game Statuses


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

Here are the valid game statuses and 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.

Learn more: the Game Status Workflow guide shows how each status maps to the right endpoint through a game's lifecycle.


Event Types


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

Here are the valid event types tracked in the Play-by-Play endpoint:

  • awardedpoint - Point awarded to (player)
  • 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)
  • 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)
  • startperiod - Start of nth period/half
  • 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>

Play-by-Play Types


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

Here are the valid turnover type descriptions:

  • 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?

Here are the valid stoppage reasons:

  • 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?

Here are the valid free throw types:

  • regular
  • technical
  • flagrant
  • clear Path
  • weighted
<freethrow made="true" free_throw_type="regular" points="1">

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

Foul Types


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

Here are the valid foul type descriptions:

  • 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?

Here are the valid ejection types:

  • Technical
  • Second Technical
  • Second Flagrant Type 1
  • Flagrant Type 2
  • Other

Court Dimensions


What is the scale of the X Y coordinates?

Unrivaled plays on a compressed full court.

The standard court size is 864 × 590 inches. For 1v1 competitions (half-court), we use 432 × 590 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=864 and width=590:

  • right-court-point = (length - x, width - y)
  • left_basket=[63, 295]
  • right_basket=[801, 295]

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 ]

Scoring


When are scores added to the schedule feeds?

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


Back to top ↑

Players & Statistics

Player Statuses


What player statuses can I expect to see?

Here are the valid player statuses:

  • 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?

Here are the valid player positions:

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

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?

Here are the valid transaction codes and types:

  • 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

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"
            }
        }
    ]
},

Back to top ↑

🙋

More questions?

Reach out to [email protected] for further assistance.



Updated about 3 hours ago

Did this page help you?

Updated about 3 hours ago

Did this page help you?

© Sportradar AG, St. Gallen, Switzerland