Unrivaled Overview

Introduction

Sportradar is the Official Data Provider of Unrivaled data. All game data feeds update in real-time as games are played and are compiled via Sportradar‘s expert in-house operators.

The Unrivaled API is consistent in structure, format, and behavior with our other League Specific APIs (e.g. WNBA, NCAAWB).

Primary endpoints return schedules, standings, team rosters, and real-time scores. Additional endpoints provide complementary data, including player transfers, injuries, and in-depth season stats.

🗝️

Authentication is required for all API calls.

🏀

Unrivaled Integration Guide

Explore our Unrivaled API Integration Guide for detailed, step-by-step guidance on how to build applications using our Unrivaled API.

Key Data Differences

The Unrivaled API follows the same structure as our existing WNBA and NCAA Women's Basketball APIs. If you are already integrated with either API, you can integrate with Unrivaled quickly.

However, there are several league-specific updates to be aware of. Below is a high-level overview of key changes. See our Unrivaled Integration Guide for more comprehensive integration details.

🏀 3-on-3 Format and 1-on-1 Tournament

Unrivaled includes both 3-on-3 games and a separate 1-on-1 midseason tournament. Some game behavior (clock rules, substitutions, period structure) differs between formats.

⛹️‍♀️ Elam Period & Game Clock Behavior

Unrivaled uses an Elam Ending to determine the winner in the final phase of the game.

This introduces:

• A new period type: elam
• Two additional clock fields: clock_type and clock_directional

Click here for detailed behavior and samples.

🏀 Weighted Free Throws

Unrivaled uses a single-attempt weighted free-throw system, where a single free throw can be worth 1, 2, or 3 points depending on the foul situation:

• 1 point: A foul committed against a player who was fouled while attempting a successful goal, technical foul, foul before the release of a throw-in, etc.
• 2 points: A foul against a player attempting an unsuccessful two-point attempt or attempting a free throw for a common foul committed against a player fouled while not in the shooting motion and the team is in the penalty.
• 3 points: A foul against a player attempting an unsuccessful three-point attempt.

Game Summary

• Includes the total weighted free-throw points for players and teams (free_throw_points).

Game Play-by-Play

• Free throw events include an attempt string value of 1 for 1, 1 for 2, or 1 for 3.
• Free throw types are signified with free_throw_type="weighted".
• Includes a freethrow.weighted_value attribute signifying one point, two point, or three point.
• Free throw descriptions include the value of the basket (for example: Napheesa Collier makes two point free throw).

          <event id="cd82e655-51e7-47b0-8fe3-7d00baeb4c44" clock="2:06" updated="2025-12-12T15:55:13+00:00" sequence="1763077333106" home_points="62" away_points="60" clock_decimal="2:06" created="2025-11-13T23:42:13+00:00" clock_type="standard" event_type="freethrowmade" attempt="1 for 2">
              <description>Rickea Jackson makes two point free throw</description>
              <attribution name="Mist" id="0780b080-347b-407b-b8d6-fa109ec23908" team_basket="left"/>
              <location coord_x="247" coord_y="285" action_area="insidecenter"/>
              <on_court>
                  <home name="Mist" id="0780b080-347b-407b-b8d6-fa109ec23908">
                      <player full_name="DiJonai Carrington" jersey_number="21" id="47169cbe-5640-460b-a840-7f438a124330"/>
                      <player full_name="Rickea Jackson" jersey_number="5" id="529366c1-1863-4b1e-b789-5a8c52124f30"/>
                      <player full_name="Breanna Stewart" jersey_number="30" id="a00515fd-bdd9-44d1-83a5-597a99316c54"/>
                  </home>
                  <away name="Lunar Owls" id="67c22115-2385-458f-8632-a67a025fef55">
                      <player full_name="Courtney Williams" jersey_number="10" id="95b03dc9-26cf-47ca-abf6-8380850d1e4e"/>
                      <player full_name="Shakira Austin" jersey_number="1" id="afd90940-4f4c-490a-8a22-1988ccc8e79d"/>
                      <player full_name="Napheesa Collier" jersey_number="24" id="fd8d4b11-3d70-450a-b65c-016bec29cc9d"/>
                  </away>
              </on_court>
              <statistics>
                  <freethrow made="true" free_throw_type="weighted" weighted_value="two point" points="2" winning_basket="false">
                      <team name="Mist" id="0780b080-347b-407b-b8d6-fa109ec23908"/>
                      <player full_name="Rickea Jackson" jersey_number="5" id="529366c1-1863-4b1e-b789-5a8c52124f30"/>
                  </freethrow>
              </statistics>
          </event>

⛹️‍♀️ Game-Winning Basket

Because every Unrivaled game ends on an Elam score, the feed includes a dedicated indicator for the final made basket.

• Game Summary provides a winning_basket data point at both the player and team level
• Seasonal Statistics and Player Profile endpoints aggregate this as winning_baskets

Click here for detailed behavior and samples.

🏀 Lineup Changes

Unrivaled includes additional substitution and rotation events:

• lineupchangeone
• lineupchangethree

These reflect fast-paced lineup swaps common to 3-on-3 basketball.

Click here for detailed behavior and samples.

⛹️‍♀️ Coordinate Dimensions

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.

See our Court Dimensions FAQ for more detail.

🏀 Awarded Points

During 1v1 competitions, a player is awarded a point if they are fouled twice in a row before making an attempt.

These awarded points appear within the Game Play-by-Play as an awardedpoint event type.

          <event id="8b7b1255-a7dc-4c2b-9a0a-926585bc8e41" clock="2:36" updated="2025-12-10T19:02:19+00:00" sequence="1765393339568" home_points="5" away_points="2" clock_decimal="2:36" created="2025-12-10T19:02:19+00:00" clock_type="elam" clock_directional="+2:36" event_type="awardedpoint">
              <description>Point awarded to Dearica Hamby</description>
              <attribution name="Dearica Hamby" id="70def231-bbfc-446d-b394-650f1959000e" team_basket="left"/>
              <location coord_x="124" coord_y="266" action_area="inthepaint"/>
              <possession name="Dearica Hamby" id="70def231-bbfc-446d-b394-650f1959000e"/>
              <on_court>
                  <home name="Skylar Diggins-Smith" id="531f9c45-b1fb-4713-8880-dc208f58ec12">
                      <player full_name="Skylar Diggins" jersey_number="4" id="bee3dbc6-82f7-4dc0-b097-0cb42a1c00a2"/>
                  </home>
                  <away name="Dearica Hamby" id="70def231-bbfc-446d-b394-650f1959000e">
                      <player full_name="Dearica Hamby" jersey_number="5" id="d840ff66-fbc9-4560-b5d6-bdd69c993039"/>
                  </away>
              </on_court>
              <statistics>
                  <awardedpoint>
                      <team name="Dearica Hamby" id="70def231-bbfc-446d-b394-650f1959000e"/>
                      <player full_name="Dearica Hamby" jersey_number="5" id="d840ff66-fbc9-4560-b5d6-bdd69c993039"/>
                  </awardedpoint>
              </statistics>
</event>

API Map

To best utilize the Unrivaled API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.

Endpoint Descriptions

Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.

Daily Injuries – Provides details for all injuries updated on a given date.

Daily Schedule – Date, time, location, and other event details for every game taking place in the league-defined day.

Daily Transfers – Information for all transfers added or edited during the league-defined day.

Game Boxscore – Top-level team scores by quarter, along with full statistics for each teams’ leaders in points, rebounds, and assists.

Game Play-by-Play – Detailed, real-time information on every team possession and game event.

Game Summary – Top-level boxscore information along with detailed game stats at the team and player levels.

Injuries – Information concerning all active Unrivaled player injuries.

League Hierarchy – League and team identification and association information.

League Leaders – Unrivaled leader information for various offensive and defensive categories including full player seasonal statistics for each player in each category.

Player Profile – Provides player biographical information and seasonal statistics.

Rankings – League ranking for each team.

Schedule – Date, time, location, and other event details for every match-up taking place in the full league season.

Seasonal Statistics – Provides complete team and player seasonal statistics for a given season and season type.

Seasons – Provides a list of all available seasons.

Series Schedule – Schedule details for every match-up in a given series.

Series Statistics – Detailed team and player statistics for a given series.

Standings – Detailed team records across an assortment of categories.

Team Profile – Provides top-level team information and a full roster of active players.

Teams – Provides a complete list of active teams in the Unrivaled API database.

Tournament List – Summarized list of all tournaments scheduled for the given season including tournament name, location, start date, and end date.

Tournament Schedule – Date, time, location, and other event details for every match-up taking place for a given tournament.

Tournament Summary – Tournament information including location, status, start date, end date, set up and participants.

Data Retrieval Samples

To find a team's leader in assists for a given game:

1. Call the season or series schedule and find the Game Id for the chosen game
2. Call the Game Boxscore using the Game Id
3. Find the Team Assists Leader statistics and locate the player full_name attribute

The name of the team's leader in assists is displayed.

To find a player's average points per game:

1. Call the season or series schedule and find id for the team the player is on
2. Call the Team Profile using the Team ID
3. Locate the Player ID for your chosen player and call the Player Profile.
4. Find the average element with the points attribute

The player's average points are displayed.

Integration Links

Integration Guide

Set up an account, learn the Unrivaled API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our Unrivaled v8 Integration Guide!

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Unrivaled API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Unrivaled API XSD schema.