ID Handling
Intro to IDs
Our NBA API features a number of unique identifiers. Some IDs are needed to request feeds, while others signify unique data.
IDs can be attributed to leagues, conferences, divisions, teams, venues, drafts, weeks, periods, quarters, coaches, managers, prospects, draft picks, trades, transactions, possessions, plays, in-game events, and many other variables.
ID Types
There are two primary ID types attributed to a variety of variables:
- UUIDs (Universally Unique Identifiers)
- SR IDs (Sportradar Identifiers)
Each directly identifies a given variable within the API, across multiple Sportradar APIs, or within data outside of Sportradar. The forms of IDs within the NBA API are detailed below.
UUID IDs
These are the primary IDs we suggest to implement in your integration. They correlate to the League Specific APIs.
UUIDs follow a specific structure: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
You'll see these UUIDs for teams, players, games, seasons, and more.
<team id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" name="76ers" alias="PHI" market="Philadelphia"/>
SR IDs
These IDs correlate to our General Sport APIs, in this case the Global Basketball API. They can have a varying structure but always begin with sr: and end with a number.
<competitor id="sr:competitor:3426" name="Minnesota Timberwolves" country="USA" country_code="USA" abbreviation="MIN" gender="male" state="MN"/>
These IDs may appear as an id or a sr_id in various APIs.
<team id="583eca2f-fb46-11e1-82cb-f4ce4684ea4c" name="Timberwolves" market="Minnesota" alias="MIN" founded="1989" sr_id="sr:team:3426">
Important Note
The
sr_idis an optional value in the NBA API and it’s strongly encouraged to utilize the UUIDs as your primary key. If you are integrating with the Global Basketball API or any of our Odds APIs, the sr_ids will be needed.You can also use the mapping endpoints found in the Global Basketball API to get the mapping for each UUID to SR ID.
IDs in other SR Products
NCAA Men's Basketball
Most NBA Players have previous experience in NCAA Men's Basketball, and thus have profiles and IDs within the NCAA Men's Basketball API. However, these unique IDs do not transfer to the NBA API.
Drafted players are added to their NBA teams within a few days after the NBA Draft. Any undrafted free agents will also be added when those signings are announced. All of these player IDs will be separate across APIs.
NCAA API player IDs will be present in the NBA Draft feeds under the source_id. This can be used to link profiles across systems if necessary.
<prospect id="782bf72e-ba49-40d3-b8ed-10b365fcf4de" source_id="c2c42723-cc6c-420e-8202-070a4023c6ff" league_id="ddee4a31-2791-4339-bfc3-a058ce2d1397" first_name="Stephon" last_name="Castle" name="Stephon Castle" position="G" height="78" weight="215" experience="FR" birth_place="Covington, GA, USA"/>
For any player absent from the Draft feeds, the method of linking their profile from the NBA API is to utilize bio information, such as their name, college, and position.
You may also leverage the Mapping Feeds within the Global Basketball API should you need to link Sportradar IDs. These Mapping feeds provide id and sr_id links for teams, players, games, and seasons.
<mapping external_id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3420"/>
<mapping external_id="583ec7cd-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3419"/>
<mapping external_id="583ecfff-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3418"/>
<mapping external_id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3417"/>
<mapping external_id="583ecfa8-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3416"/>
<mapping external_id="7a30c43d-a206-476d-b5b2-75b419445ae9" id="sr:player:1176252"/>
<mapping external_id="20690402-3651-4ad5-8637-2cb1081bbb06" id="sr:player:2859809"/>
<mapping external_id="4d98d238-6a96-4770-ac25-3cec68b4f90c" id="sr:player:2859775"/>
<mapping external_id="01990f34-37fa-40c5-83ae-bd4da18a6901" id="sr:player:2859773"/>
<mapping external_id="2ee308da-2d15-42af-9e0d-7a4b211d07dd" id="sr:player:2859771"/>
<mapping external_id="e6d5aefa-59ef-49af-8fc2-bc27dc07ca99" id="sr:sport_event:53286421"/>
<mapping external_id="fdfc9371-22d3-4c8e-b95c-50b847a29505" id="sr:sport_event:53286415"/>
<mapping external_id="c12abfc2-ea49-49ad-a8bf-a26abed68c27" id="sr:sport_event:53336599"/>
<mapping external_id="35d392a6-d9b6-4225-97dd-c6e72b47c0d9" id="sr:sport_event:52864745"/>
<mapping external_id="8cbdc7e2-f9cb-4b89-92a4-05bcd57169d6" id="sr:sport_event:52866623"/>
<mapping external_id="a871223e-1e70-419e-8697-c0c1c010a7a9" id="sr:season:105257"/>
<mapping external_id="3dcf4c11-e7f8-4996-a34d-49069d14d465" id="sr:season:104315"/>
<mapping external_id="6d242a1f-93d0-48e4-96c0-45ff92ba607e" id="sr:season:105255"/>
<mapping external_id="7aa53f56-bde6-441f-966b-161ecd993de5" id="sr:season:104319"/>
<mapping external_id="db004e22-7ed4-4316-8302-79454224f49d" id="sr:season:112470"/>
NBA G League
Player IDs from the NBA API are not synced to the NBA G League API. However, Venue IDs are synced between both APIs.
The Sportradar IDs will be consistent across sports and leagues, where available.
Global Basketball
The Global Basketball API covers NBA data at a much lower tier, and is based on the sr_id system, with IDs that look like: sr:competitor:3420 or sr:sport_event:53286421.
Make use of the Mapping Feeds within Global Basketball should you need to link between APIs. These feeds provide id and sr_id links for teams, players, games, and seasons.
<mapping external_id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3420"/>
<mapping external_id="583ec7cd-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3419"/>
<mapping external_id="583ecfff-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3418"/>
<mapping external_id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3417"/>
<mapping external_id="583ecfa8-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3416"/>
<mapping external_id="7a30c43d-a206-476d-b5b2-75b419445ae9" id="sr:player:1176252"/>
<mapping external_id="20690402-3651-4ad5-8637-2cb1081bbb06" id="sr:player:2859809"/>
<mapping external_id="4d98d238-6a96-4770-ac25-3cec68b4f90c" id="sr:player:2859775"/>
<mapping external_id="01990f34-37fa-40c5-83ae-bd4da18a6901" id="sr:player:2859773"/>
<mapping external_id="2ee308da-2d15-42af-9e0d-7a4b211d07dd" id="sr:player:2859771"/>
<mapping external_id="e6d5aefa-59ef-49af-8fc2-bc27dc07ca99" id="sr:sport_event:53286421"/>
<mapping external_id="fdfc9371-22d3-4c8e-b95c-50b847a29505" id="sr:sport_event:53286415"/>
<mapping external_id="c12abfc2-ea49-49ad-a8bf-a26abed68c27" id="sr:sport_event:53336599"/>
<mapping external_id="35d392a6-d9b6-4225-97dd-c6e72b47c0d9" id="sr:sport_event:52864745"/>
<mapping external_id="8cbdc7e2-f9cb-4b89-92a4-05bcd57169d6" id="sr:sport_event:52866623"/>
<mapping external_id="a871223e-1e70-419e-8697-c0c1c010a7a9" id="sr:season:105257"/>
<mapping external_id="3dcf4c11-e7f8-4996-a34d-49069d14d465" id="sr:season:104315"/>
<mapping external_id="6d242a1f-93d0-48e4-96c0-45ff92ba607e" id="sr:season:105255"/>
<mapping external_id="7aa53f56-bde6-441f-966b-161ecd993de5" id="sr:season:104319"/>
<mapping external_id="db004e22-7ed4-4316-8302-79454224f49d" id="sr:season:112470"/>
Access
Please note that you will need access to the Global Basketball API in your account to make use of these endpoints.
Odds
The Odds APIs include NBA odds data, and are based on the sr_id system, with IDs that look like: sr:competitor:3420 or sr:sport_event:53286421.
Make use of the Mapping Feeds within each Odds API should you need to link IDs between APIs. These feeds provide id and sr_id links for leagues (Competitions), teams (Competitors), players, and games (Sport Events).
<mapping external_id="64e90d00-9ea0-4c91-8292-e78414439d54" id="sr:competition:8"/>
<mapping external_id="ea97fe54-4712-4bd7-b643-8409887f9f61" id="sr:competition:16"/>
<mapping external_id="fdc32c0e-2a6a-4bbe-b855-41fef6369bfe" id="sr:competition:17"/>
<mapping external_id="cd24a25b-3fc0-48fd-9c54-f793d51af976" id="sr:competition:23"/>
<mapping external_id="3c6d318a-6164-4290-9bbc-bf9bb21cc4b8" id="sr:competition:31"/>
<mapping external_id="65da41c2-5231-42a1-acb9-7fe295b12fc7" id="sr:competitor:1"/>
<mapping external_id="eb9aa424-85af-443d-a7c1-8a8614637d8e" id="sr:competitor:2"/>
<mapping external_id="b1ef96b0-be25-48b6-b6c5-c4d876116110" id="sr:competitor:3"/>
<mapping external_id="2c669de5-7b24-46f2-8d2b-715784f8ac4d" id="sr:competitor:4"/>
<mapping external_id="b8c90280-978c-40fc-8cb8-35996992825f" id="sr:competitor:5"/>
<mapping external_id="036f914a-aad0-4ff1-9771-54f9e963d1b8" id="sr:player:996277"/>
<mapping external_id="252f4b13-6abb-45dc-ae85-f822b817cb51" id="sr:player:1605464"/>
<mapping external_id="31a50d54-ef46-47a8-863c-6f4d4e5aa184" id="sr:player:607928"/>
<mapping external_id="3f64e9a6-6e1e-499b-aec8-764c99f634b2" id="sr:player:857970"/>
<mapping external_id="51ee792b-20c1-4ce5-b123-53fa05cb943e" id="sr:player:922298"/>
<mapping external_id="5ca22b1c-3ede-4a91-bbe8-456179e8e230" id="sr:sport_event:50733635"/>
<mapping external_id="ab166a44-3adb-4195-ab29-ca60eb2ea7c8" id="sr:sport_event:50690883"/>
<mapping external_id="a75e6ddd-6570-4584-9323-9bb363f40cf3" id="sr:sport_event:50690877"/>
<mapping external_id="eee98b92-75b6-474e-a27f-43e562baeb2b" id="sr:sport_event:50690787"/>
<mapping external_id="dbfa2bd2-15c2-46a6-bfd4-75b8543a970a" id="sr:sport_event:50690785"/>
Access
Please note that you will need access to the Odds APIs in your account to make use of these endpoints.
Images & Editorial
Our Images and Editorial APIs include both UUID and SR IDs within image and article entries (under entity_id). This allows you to sync player, team, and game IDs to this content.
<asset id="e7ae0795-6c40-445a-a980-68770573fbe0" created="2023-10-11T23:29:07+00:00" updated="2023-10-11T23:29:20+00:00" player_id="28a2e698-9f33-4d4d-9a5d-9bea66ee42a1" posed="false">
<title>
<![CDATA[John Collins]]>
</title>
<description>
<![CDATA[NBA: 2023 Season Player Headshots ]]>
</description>
<copyright>USA Today Sports Images</copyright>
<links>
<link width="1200" height="1200" href="/headshots/players/e7ae0795-6c40-445a-a980-68770573fbe0/original.jpg"/>
<link width="250" height="250" href="/headshots/players/e7ae0795-6c40-445a-a980-68770573fbe0/250w-resize.jpg"/>
</links>
<refs>
<ref name="Collins, John" type="profile" sport="nba" sportradar_id="28a2e698-9f33-4d4d-9a5d-9bea66ee42a1" primary="true">
<entity_id origin="SR" id="sr:player:1141198" sport="nba"/>
<entity_id origin="SD" id="28a2e698-9f33-4d4d-9a5d-9bea66ee42a1" sport="nba"/>
<entity_id origin="NBA" id="1628381" sport="nba"/>
</ref>
<ref name="Utah Jazz" type="organization" sport="nba" sportradar_id="583ece50-fb46-11e1-82cb-f4ce4684ea4c">
<entity_id origin="SR" id="sr:competitor:3434" sport="nba"/>
<entity_id origin="SD" id="583ece50-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
<entity_id origin="NBA" id="1610612762" sport="nba"/>
</ref>
</refs>
<provider name="usat">
<provider_item_id>21624631</provider_item_id>
<original_publish>2023-10-11T17:04:19+00:00</original_publish>
</provider>
</asset>
<assetlist xmlns="http://feed.elasticstats.com/schema/assets/manifest-v2.5.xsd" provider="getty" league="nba" type="headshot" entity="players" manifest_date="2024-03-09T13:08:27+00:00">
<asset id="ef051303-e438-44a3-9739-9e354997bb59" created="2023-10-17T15:00:21+00:00" updated="2024-03-08T23:41:17+00:00" player_id="dc929037-1cbf-4a60-a4d8-59636641ae88" posed="true">
<title>
<![CDATA[2023-24 Portland Trail Blazers Media Day]]>
</title>
<description>
<![CDATA[PORTLAND, OR - OCTOBER 2: Doup Reath #26 of the Portland Trail Blazers poses for head shot during 2023-24 NBA Media Day on October 2, 2023 at the Moda Center Arena in Portland, Oregon. NOTE TO USER: User expressly acknowledges and agrees that, by downloading and or using this photograph, user is consenting to the terms and conditions of the Getty Images License Agreement. Mandatory Copyright Notice: Copyright 2023 NBAE (Photo by Jaden Cole/NBAE via Getty Images)]]>
</description>
<copyright>Getty</copyright>
<links>
<link width="2828" height="1895" href="/headshots/players/ef051303-e438-44a3-9739-9e354997bb59/original.png"/>
<link width="250" height="168" href="/headshots/players/ef051303-e438-44a3-9739-9e354997bb59/250w-resize.png"/>
</links>
<refs>
<ref name="Reath, Duop" type="profile" sport="nba" sportradar_id="dc929037-1cbf-4a60-a4d8-59636641ae88" primary="true">
<entity_id origin="SR" id="sr:player:1164928" sport="nba"/>
<entity_id origin="SD" id="dc929037-1cbf-4a60-a4d8-59636641ae88" sport="nba"/>
<entity_id origin="NBA" id="1641871" sport="nba"/>
</ref>
<ref name="Portland Trail Blazers" type="organization" sport="nba" sportradar_id="583ed056-fb46-11e1-82cb-f4ce4684ea4c">
<entity_id origin="SR" id="sr:competitor:3414" sport="nba"/>
<entity_id origin="SD" id="583ed056-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
<entity_id origin="NBA" id="1610612757" sport="nba"/>
</ref>
</refs>
<provider name="getty">
<provider_item_id>1704495522</provider_item_id>
<original_publish>2023-10-02T00:00:00+00:00</original_publish>
</provider>
</asset>
Widgets
Our NBA Widgets often will require the input of a unique game, team, player, or season ID. Each of these are the sr_ids found in the NBA API.
Game IDs
Each NBA game will have its own unique identifier under game.id. See below for a sample taken from the Schedule endpoint.
<game id="4c189e09-fabf-4608-a2bf-f0f77d8e2bbf" status="scheduled" coverage="full" scheduled="2024-10-23T02:00:00Z" track_on_court="true" sr_id="sr:match:52632021" reference="0022400062" home_team="583ecae2-fb46-11e1-82cb-f4ce4684ea4c" away_team="583eca2f-fb46-11e1-82cb-f4ce4684ea4c">
<time_zones venue="US/Pacific" home="US/Pacific" away="US/Central"/>
<venue id="792ec100-691e-5e16-8ef8-79b2b6ee38ba" name="Crypto.com Arena" capacity="18997" address="1111 S. Figueroa Street" city="Los Angeles" state="CA" zip="90015" country="USA" sr_id="sr:venue:6008">
<location lat="34.043059" lng="-118.267223"/>
</venue>
<home name="Los Angeles Lakers" alias="LAL" id="583ecae2-fb46-11e1-82cb-f4ce4684ea4c" sr_id="sr:team:3427" reference="1610612747"></home>
<away name="Minnesota Timberwolves" alias="MIN" id="583eca2f-fb46-11e1-82cb-f4ce4684ea4c" sr_id="sr:team:3426" reference="1610612750"></away>
<broadcasts>
<broadcast network="TNT" type="TV" locale="National" channel="245"/>
</broadcasts>
</game>
"games": [
{
"id": "a06b10fa-fd80-4058-9e0a-d3d1d69cb6f1",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-10-22T23:30:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631111",
"reference": "0022400061",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "7d69b080-91ca-53c9-9302-45c1a72c5549",
"name": "TD Garden",
"capacity": 18624,
"address": "100 Legends Way",
"city": "Boston",
"state": "MA",
"zip": "02114",
"country": "USA",
"sr_id": "sr:venue:5940",
"location": {
"lat": "42.366303",
"lng": "-71.062228"
}
},
Once created, game IDs are unchanging, except in the rare case that a game is postponed, or a game is mistakenly created twice (the duplicated UUID would be removed).
Team IDs
Each NBA team will have its own unique identifier under team.id. You can locate all active teams in the League Hierarchy feed, and all active teams in our NBA database in the Teams feed.
<team id="445dd038-f82e-4d33-936c-f480f11079ba" name="36ers" alias="ADL" market="Adelaide"/>
<team id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" name="76ers" alias="PHI" market="Philadelphia"/>
<team id="7c2943d4-0438-434e-abbb-6b2e9acb1b87" name="Baloncesto" alias="RMD" market="Madrid"/>
{
"id": "3960cfac-7361-4b30-bc25-8d393de6f62f",
"name": "EASTERN CONFERENCE",
"alias": "EASTERN",
"divisions": [
{
"id": "54dc7348-c1d2-40d8-88b3-c4c0138e085d",
"name": "Southeast",
"alias": "SOUTHEAST",
"teams": [
{
"id": "583ec8d4-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Wizards",
"market": "Washington",
"alias": "WAS",
"sr_id": "sr:team:3431",
"founded": 1961,
"owner": "Ted Leonsis",
"general_manager": "Will Dawkins",
"president": "Michael Winger",
"mascot": "G-Wiz, G-Man",
"sponsor": "Robinhood",
"championships_won": 1,
"championship_seasons": "1978",
"conference_titles": 4,
"division_titles": 8,
"retired_numbers": "10, 11, 25, 41, 45",
"playoff_appearances": 30,
"gleague_affiliate": "Capital City Go-Go",
"reference": "1610612764",
"team_colors": [
{
"type": "secondary",
"hex_color": "#e31837",
"rgb_color": {
"red": 227,
"green": 24,
"blue": 55
}
},
{
"type": "primary",
"hex_color": "#002b5c",
"rgb_color": {
"red": 0,
"green": 43,
"blue": 92
}
}
],
"venue": {
"id": "f62d5b49-d646-56e9-ba60-a875a00830f8",
"name": "Capital One Arena",
"capacity": 20356,
"address": "601 F Street NW",
"city": "Washington",
"state": "DC",
"zip": "20004",
"country": "USA",
"sr_id": "sr:venue:6016",
"location": {
"lat": "38.898056",
"lng": "-77.020833"
}
}
},
{
"id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Hornets",
"market": "Charlotte",
"alias": "CHA",
"sr_id": "sr:team:3430",
"founded": 1988,
"owner": "Gabe Plotkin & Rick Schnall",
"general_manager": "Mitch Kupchak",
"mascot": "Hugo the Hornet",
"sponsor": "Feastables",
"championships_won": 0,
"conference_titles": 0,
"division_titles": 0,
"retired_numbers": "13",
"playoff_appearances": 10,
"gleague_affiliate": "Greensboro Swarm",
"reference": "1610612766",
"team_colors": [
{
"type": "secondary",
"hex_color": "#1d1160",
"rgb_color": {
"red": 29,
"green": 17,
"blue": 96
}
},
{
"type": "primary",
"hex_color": "#00788c",
"rgb_color": {
"red": 0,
"green": 120,
"blue": 140
}
}
],
"venue": {
"id": "a380f011-6e5d-5430-9f37-209e1e8a9b6f",
"name": "Spectrum Center",
"capacity": 19077,
"address": "330 E. Trade Street",
"city": "Charlotte",
"state": "NC",
"zip": "28202",
"country": "USA",
"sr_id": "sr:venue:6146",
"location": {
"lat": "35.225148",
"lng": "-80.839249"
}
}
}
]
}
]
}
Team Relocation
Team IDs will not change once created. Even if a team relocates their ID will remain the same.
TBD Teams
Within the Teams feed, you will find a TBD team. This unique ID can be used to populate game information when game matchups are not yet known. You can find more info on this process in the Playoffs integration scenario.
<team id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" name="TBD" market="Team" alias="TBD"/>
Player IDs
Each NBA player will have their own unique identifier under player.id. You can locate all active players on a given team in the Team Profile endpoint, and retrieve detailed player biographical info and stats in the Player Profile endpoint.
Player IDs will not change once created.
<team xmlns="http://feed.elasticstats.com/schema/basketball/team-v8.0.xsd" id="583eca2f-fb46-11e1-82cb-f4ce4684ea4c" name="Timberwolves" market="Minnesota" alias="MIN" founded="1989" sr_id="sr:team:3426" owner="Glen Taylor" general_manager="Tim Connelly" president="Tim Connelly" mascot="Crunch the Wolf" nicknames="Wolves, T-Wolves" sponsor="Sezzle" championships_won="0" conference_titles="0" division_titles="1" retired_numbers="2" playoff_appearances="12" gleague_affiliate="Iowa Wolves" reference="1610612750">
<venue id="7aed802e-3562-5b73-af1b-3859529f9b95" name="Target Center" capacity="19356" address="600 First Avenue North" city="Minneapolis" state="MN" zip="55403" country="USA" sr_id="sr:venue:6930">
<location lat="44.979444" lng="-93.276111"/>
</venue>
<hierarchy>
<league id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA"/>
<conference id="7fe7e212-de01-4f8f-a31d-b9f0a95731e3" name="WESTERN CONFERENCE" alias="WESTERN"/>
<division id="12bf14ba-eb16-4c6f-8275-e801b6947c1e" name="Northwest" alias="NORTHWEST"/>
</hierarchy>
<coaches>
<coach id="fc135b85-7a10-4df9-b32b-6e23b0ca04a2" full_name="Chris Finch" first_name="Chris" last_name="Finch" position="Head Coach" experience="5" reference="202896"/>
</coaches>
<team_colors>
<team_color type="primary" hex_color="#0c2340">
<rgb_color red="12" green="35" blue="64"/>
</team_color>
<team_color type="secondary" hex_color="#236192">
<rgb_color red="35" green="97" blue="146"/>
</team_color>
</team_colors>
<players>
<player id="1b807c23-716f-4117-bc86-35553ced0cac" status="TWO-WAY" full_name="Jesse Edwards" first_name="Jesse" last_name="Edwards" abbr_name="J.Edwards" height="83" weight="240" position="C" primary_position="C" experience="0" college="West Virginia" high_school="IMG Academy (FL)" birth_place="Amsterdam,, NLD" birthdate="2000-03-18" updated="2024-07-16T17:46:19Z" sr_id="sr:player:1835936">
<draft year="2024"/>
</player>
<player id="2b95727a-4273-4f8f-a45b-3d9ac9969dba" status="ACT" full_name="Terrence Shannon Jr." first_name="Terrence" last_name="Shannon" abbr_name="T.Shannon" height="78" weight="219" position="G" primary_position="SG" jersey_number="00" experience="0" college="Illinois" high_school="IMG Academy (FL)" birth_place="Chicago, IL, USA" birthdate="2000-07-30" updated="2024-07-21T00:30:20Z" name_suffix="Jr." sr_id="sr:player:1875284">
<draft team_id="583eca2f-fb46-11e1-82cb-f4ce4684ea4c" year="2024" round="1" pick="27"/>
</player>
<player id="37fbc3a5-0d10-4e22-803b-baa2ea0cdb12" status="ACT" full_name="Rudy Gobert" first_name="Rudy" last_name="Gobert" abbr_name="R.Gobert" height="85" weight="258" position="C" primary_position="C" jersey_number="27" experience="11" birth_place="Saint-Quentin,, FRA" birthdate="1992-06-26" updated="2024-07-21T00:33:10Z" sr_id="sr:player:607808" rookie_year="2013" reference="203497">
<draft team_id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" year="2013" round="1" pick="27"/>
</player>
<player id="460b7264-b98f-483e-b841-59a18c2e4d67" status="ACT" full_name="Mike Conley" first_name="Mike" last_name="Conley" abbr_name="M.Conley" height="72" weight="175" position="G" primary_position="PG" jersey_number="10" experience="17" college="Ohio State" high_school="Lawrence North (IN)" birth_place="Fayetteville, AR, USA" birthdate="1987-10-11" updated="2024-07-21T00:31:23Z" sr_id="sr:player:608194" rookie_year="2007" reference="201144">
<draft team_id="583eca88-fb46-11e1-82cb-f4ce4684ea4c" year="2007" round="1" pick="4"/>
</player>
<player id="5b297372-b2af-445e-a4bc-777982dbc1e3" status="ACT" full_name="Joe Ingles" first_name="Joe" last_name="Ingles" abbr_name="J.Ingles" height="81" weight="220" position="F-G" primary_position="SF" jersey_number="7" experience="10" high_school="Lake Ginninderra (AUS)" birth_place="Adelaide,, AUS" birthdate="1987-10-02" updated="2024-07-21T00:31:05Z" sr_id="sr:player:611966" rookie_year="2014" reference="204060">
<draft year="2009"/>
</player>
<player id="7b526b14-5d50-411e-8bea-0ac7a8d0e8d7" status="ACT" full_name="Leonard Miller" first_name="Leonard" last_name="Miller" abbr_name="L.Miller" height="82" weight="210" position="F" primary_position="SF" jersey_number="33" experience="1" high_school="Fort Erie International Academy (CAN)" birth_place="Thornhill, ON, CAN" birthdate="2003-11-26" updated="2024-07-16T18:30:11Z" sr_id="sr:player:2460711" rookie_year="2023" reference="1631159">
<draft team_id="583ecd4f-fb46-11e1-82cb-f4ce4684ea4c" year="2023" round="2" pick="33"/>
</player>
<player id="7f11cfe9-30d3-492a-9033-08cf2324a73e" status="TWO-WAY" full_name="Daishen Nix" first_name="Daishen" last_name="Nix" abbr_name="D.Nix" height="75" weight="226" position="G" primary_position="PG" jersey_number="12" experience="3" high_school="Trinity International (NV)" birth_place="Fairbanks, AK, USA" birthdate="2002-02-13" updated="2024-07-21T00:31:39Z" sr_id="sr:player:2208736" rookie_year="2021" reference="1630227">
<draft year="2021"/>
</player>
<player id="823b2161-0c34-494c-9d7c-b438152f4f4d" status="ACT" full_name="Naz Reid" first_name="Naz" last_name="Reid" abbr_name="N.Reid" height="81" weight="264" position="C" primary_position="C" jersey_number="11" experience="5" college="LSU" high_school="Roselle Catholic (NJ)" birth_place="Asbury Park, NJ, USA" birthdate="1999-08-26" updated="2024-07-21T00:31:29Z" sr_id="sr:player:1796560" rookie_year="2019" reference="1629675">
<draft year="2019"/>
</player>
{
"id": "8ec91366-faea-4196-bbfd-b8fab7434795",
"status": "ACT",
"full_name": "Stephen Curry",
"first_name": "Stephen",
"last_name": "Curry",
"abbr_name": "S.Curry",
"height": 74,
"weight": 185,
"position": "G",
"primary_position": "PG",
"jersey_number": "30",
"experience": "15",
"college": "Davidson",
"high_school": "Charlotte Christian (NC)",
"birth_place": "Akron, OH, USA",
"birthdate": "1988-03-14",
"updated": "2024-07-19T01:29:22Z",
"sr_id": "sr:player:608110",
"rookie_year": 2009,
"reference": "201939",
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"team": {
"id": "583ec825-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Warriors",
"market": "Golden State",
"alias": "GSW",
"sr_id": "sr:team:3428",
"reference": "1610612744"
},
"draft": {
"team_id": "583ec825-fb46-11e1-82cb-f4ce4684ea4c",
"year": 2009,
"round": "1",
"pick": "7"
},
"seasons": [
{
"id": "f1162fd1-29c5-4c29-abb4-57b78f16d238",
"year": 2023,
"type": "REG",
"teams": [
{
"id": "583ec825-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Warriors",
"market": "Golden State",
"alias": "GSW",
"sr_id": "sr:team:3428",
"reference": "1610612744",
"total": {
"games_played": 74,
"games_started": 74,
"minutes": 2421,
"field_goals_made": 650,
"field_goals_att": 1445,
"field_goals_pct": 0.45,
"two_points_made": 293,
"two_points_att": 569,
"two_points_pct": 0.515,
"three_points_made": 357,
"three_points_att": 876,
"three_points_pct": 0.408,
"blocked_att": 51,
"free_throws_made": 299,
"free_throws_att": 324,
"free_throws_pct": 0.923,
"offensive_rebounds": 37,
"defensive_rebounds": 293,
"rebounds": 330,
"assists": 379,
"turnovers": 210,
"assists_turnover_ratio": 1.8,
"steals": 54,
"blocks": 28,
"personal_fouls": 117,
"tech_fouls": 2,
"points": 1956,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"tech_fouls_non_unsportsmanlike": 1,
"true_shooting_att": 1587.56,
"true_shooting_pct": 0.616,
"efficiency": 1717,
"field_goals_at_rim_made": 84,
"field_goals_at_rim_att": 128,
"field_goals_at_rim_pct": 0.656,
"field_goals_at_midrange_made": 75,
"field_goals_at_midrange_att": 179,
"field_goals_at_midrange_pct": 0.419,
"usage_pct": 31.45,
"points_off_turnovers": 261,
"points_in_paint": 434,
"points_in_paint_made": 217,
"points_in_paint_att": 386,
"points_in_paint_pct": 0.562,
"effective_fg_pct": 0.573,
"double_doubles": 7,
"triple_doubles": 0,
"fouls_drawn": 271,
"offensive_fouls": 15,
"fast_break_pts": 173,
"fast_break_att": 128,
"fast_break_made": 60,
"fast_break_pct": 0.469,
"coach_ejections": 0,
"second_chance_pct": 0.524,
"second_chance_pts": 190,
"second_chance_att": 126,
"second_chance_made": 66,
"minus": 5868,
"plus": 6057,
"coach_tech_fouls": 0
},
"average": {
"minutes": 32.7,
"points": 26.4,
"off_rebounds": 0.5,
"def_rebounds": 3.96,
"rebounds": 4.46,
"assists": 5.1,
"steals": 0.73,
"blocks": 0.38,
"turnovers": 2.84,
"personal_fouls": 1.58,
"flagrant_fouls": 0,
"blocked_att": 0.69,
"field_goals_made": 8.78,
"field_goals_att": 19.53,
"three_points_made": 4.82,
"three_points_att": 11.84,
"free_throws_made": 4.04,
"free_throws_att": 4.38,
"two_points_made": 3.96,
"two_points_att": 7.69,
"efficiency": 23.2,
"true_shooting_att": 21.45,
"points_off_turnovers": 3.53,
"points_in_paint_made": 2.93,
"points_in_paint_att": 5.22,
"points_in_paint": 5.86,
"fouls_drawn": 3.66,
"offensive_fouls": 0.2,
"fast_break_pts": 2.34,
"fast_break_att": 1.73,
"fast_break_made": 0.81,
"second_chance_pts": 2.57,
"second_chance_att": 1.7,
"second_chance_made": 0.89
}
}
]
}
]
}
Player IDs in other Products
Each NBA player.id is specific to the NBA API. IDs will not transfer to other basketball APIs. To learn more about linking IDs across API products visit this section.
Duplicate Player IDs
A duplicate player profile (and player.id) can be introduced by mistake. In these cases, we will mark the duplicate player with a status of DUP. All profiles marked as duplicates can be ignored, but they will remain in our database to limit confusion.
<player
xmlns="http://feed.elasticstats.com/schema/basketball/profile-v7.0.xsd" id="1b807c23-716f-4117-bc86-35553ced0cac" status="DUP" full_name="Jesse Edwards" first_name="Jesse" last_name="Edwards" abbr_name="J.Edwards" height="83" weight="240" position="C" primary_position="C" experience="0" college="West Virginia" high_school="IMG Academy (FL)" birth_place="Amsterdam,, NLD" birthdate="2000-03-18" updated="2024-07-16T17:46:19Z" sr_id="sr:player:1835936">
<league id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA"/>
<team id="583eca2f-fb46-11e1-82cb-f4ce4684ea4c" name="Timberwolves" market="Minnesota" alias="MIN" sr_id="sr:team:3426" reference="1610612750"/>
<draft year="2024"/>
</player>
{
"id": "1b807c23-716f-4117-bc86-35553ced0cac",
"status": "DUP",
"full_name": "Jesse Edwards",
"first_name": "Jesse",
"last_name": "Edwards",
"abbr_name": "J.Edwards",
"height": 83,
"weight": 240,
"position": "C",
"primary_position": "C",
"experience": "0",
"college": "West Virginia",
"high_school": "IMG Academy (FL)",
"birth_place": "Amsterdam,, NLD",
"birthdate": "2000-03-18",
"updated": "2024-07-16T17:46:19Z",
"sr_id": "sr:player:1835936",
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"team": {
"id": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Timberwolves",
"market": "Minnesota",
"alias": "MIN",
"sr_id": "sr:team:3426",
"reference": "1610612750"
},
"draft": {
"year": 2024
},
"seasons": []
}
Access all Player IDs
Iterate through the past Seasonal Statistics feeds for each season and team to obtain all player IDs in the NBA API.
Season IDs
Each NBA season will have its own unique identifier under season.id. Season types can be Preseason (PRE), Regular Season (Regular), Play-In-Tournament (PIT), In-Season Tournament (IST) or Postseason (PST). You can locate all historical seasons in the Seasons feed.
Season IDs will not change once created.
<league xmlns="http://feed.elasticstats.com/schema/basketball/seasons-v6.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
<season id="c70d6199-91f3-452d-af2e-118831957813" year="2024" start_date="2024-10-04" end_date="2024-10-18" status="scheduled">
<type code="PRE" name="Pre-season"/>
</season>
<season id="64bb5ffa-bd55-4ea3-b7f8-efc4959c1187" year="2024" start_date="2025-04-19" status="scheduled">
<type code="PST" name="Post-season"/>
</season>
<season id="05294da5-e84d-4e87-a331-c29dbeca2c69" year="2024" start_date="2025-04-15" end_date="2025-04-18" status="scheduled">
<type code="PIT" name="Play-in Tournament"/>
</season>
<season id="970c9b10-2985-4718-b89d-96cfdc0a5e98" year="2024" start_date="2024-10-22" end_date="2025-04-13" status="scheduled">
<type code="REG" name="Regular Season"/>
</season>
<season id="043889a3-440f-4494-a41c-d5513900bae6" year="2024" start_date="2024-12-17" end_date="2024-12-18" status="scheduled">
<type code="IST" name="In-Season Tournament"/>
</season>
</league>
{
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"seasons": [
{
"id": "0d858257-7bc3-435d-9e54-1c8590be84ce",
"year": 2023,
"start_date": "2023-10-05",
"end_date": "2023-10-20",
"status": "closed",
"type": {
"code": "PRE",
"name": "Pre-season"
}
},
{
"id": "8905ddd2-e5f0-4734-b9ef-c9c3452b72d2",
"year": 2023,
"start_date": "2024-04-20",
"end_date": "2024-06-17",
"status": "closed",
"type": {
"code": "PST",
"name": "Post-season"
}
},
{
"id": "851f97e4-c830-4590-88e9-e1286383148c",
"year": 2023,
"start_date": "2024-04-16",
"end_date": "2024-04-19",
"status": "closed",
"type": {
"code": "PIT",
"name": "Play-in Tournament"
}
},
{
"id": "f1162fd1-29c5-4c29-abb4-57b78f16d238",
"year": 2023,
"start_date": "2023-10-24",
"end_date": "2024-04-14",
"status": "closed",
"type": {
"code": "REG",
"name": "Regular Season"
}
},
{
"id": "170cfa7b-54e8-468b-ab9f-21244769bd75",
"year": 2023,
"start_date": "2023-12-09",
"end_date": "2023-12-10",
"status": "closed",
"type": {
"code": "IST",
"name": "In-Season Tournament"
}
},
{
"id": "c70d6199-91f3-452d-af2e-118831957813",
"year": 2024,
"start_date": "2024-10-04",
"end_date": "2024-10-18",
"status": "scheduled",
"type": {
"code": "PRE",
"name": "Pre-season"
}
},
{
"id": "64bb5ffa-bd55-4ea3-b7f8-efc4959c1187",
"year": 2024,
"start_date": "2025-04-19",
"status": "scheduled",
"type": {
"code": "PST",
"name": "Post-season"
}
},
{
"id": "05294da5-e84d-4e87-a331-c29dbeca2c69",
"year": 2024,
"start_date": "2025-04-15",
"end_date": "2025-04-18",
"status": "scheduled",
"type": {
"code": "PIT",
"name": "Play-in Tournament"
}
},
{
"id": "970c9b10-2985-4718-b89d-96cfdc0a5e98",
"year": 2024,
"start_date": "2024-10-22",
"end_date": "2025-04-13",
"status": "scheduled",
"type": {
"code": "REG",
"name": "Regular Season"
}
},
{
"id": "043889a3-440f-4494-a41c-d5513900bae6",
"year": 2024,
"start_date": "2024-12-17",
"end_date": "2024-12-18",
"status": "scheduled",
"type": {
"code": "IST",
"name": "In-Season Tournament"
}
}
]
}
Venue IDs
Each NBA venue will have its own unique identifier under venue.id. You can locate all active team venues in League Hierarchy, and each Game feed will include the venue ID for that matchup.
Venue IDs will not change once created.
<team id="583ecb8f-fb46-11e1-82cb-f4ce4684ea4c" name="Hawks" market="Atlanta" alias="ATL" sr_id="sr:team:3423" founded="1946" owner="Tony Ressler" general_manager="Landry Fields" president="Steve Koonin" mascot="Harry the Hawk" sponsor="YMCA of Metro Atlanta" championships_won="1" championship_seasons="1958" conference_titles="0" division_titles="12" retired_numbers="9, 21, 23, 44, 55" playoff_appearances="49" gleague_affiliate="College Park Skyhawks" reference="1610612737">
<team_colors>
<team_color type="primary" hex_color="#c8102e">
<rgb_color red="200" green="16" blue="46"/>
</team_color>
<team_color type="secondary" hex_color="#fdb927">
<rgb_color red="253" green="185" blue="39"/>
</team_color>
</team_colors>
<venue id="fd21f639-8a47-51ac-a5dd-590629d445cf" name="State Farm Arena" capacity="18118" address="One Philips Drive" city="Atlanta" state="GA" zip="30303" country="USA" sr_id="sr:venue:6916">
<location lat="33.757162" lng="-84.396352"/>
</venue>
</team>
{
"id": "583ecb8f-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Hawks",
"market": "Atlanta",
"alias": "ATL",
"sr_id": "sr:team:3423",
"founded": 1946,
"owner": "Tony Ressler",
"general_manager": "Landry Fields",
"president": "Steve Koonin",
"mascot": "Harry the Hawk",
"sponsor": "YMCA of Metro Atlanta",
"championships_won": 1,
"championship_seasons": "1958",
"conference_titles": 0,
"division_titles": 12,
"retired_numbers": "9, 21, 23, 44, 55",
"playoff_appearances": 49,
"gleague_affiliate": "College Park Skyhawks",
"reference": "1610612737",
"team_colors": [
{
"type": "primary",
"hex_color": "#c8102e",
"rgb_color": {
"red": 200,
"green": 16,
"blue": 46
}
},
{
"type": "secondary",
"hex_color": "#fdb927",
"rgb_color": {
"red": 253,
"green": 185,
"blue": 39
}
}
],
"venue": {
"id": "fd21f639-8a47-51ac-a5dd-590629d445cf",
"name": "State Farm Arena",
"capacity": 18118,
"address": "One Philips Drive",
"city": "Atlanta",
"state": "GA",
"zip": "30303",
"country": "USA",
"sr_id": "sr:venue:6916",
"location": {
"lat": "33.757162",
"lng": "-84.396352"
}
}
}
The Sportradar IDs will be consistent across sports and leagues, where available. Meaning those venue IDs would be consistent across APIs.
Updated about 1 month ago