Find all updates to the NBA v5 API and its documentation
Ten-Day Contract Status
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/28/2024 | Player Profile Team Profile | We've added a status (TEN-DAY) for players currently on a 10-day contract. |
Parent Ids
| Release Date | Benefit |
|---|---|
| 09/23/2024 | Added a standard parent Id (parent_id) to games and series.Use this Id to group events (like the All-Star game or NBA Finals) across seasons. |
{
"id": "54d776dc-0e88-4c77-8fe0-021d4ed7b250",
"status": "closed",
"title": "2024 NBA All-Star Game",
"coverage": "full",
"scheduled": "2024-02-19T01:00:00Z",
"home_points": 211,
"away_points": 186,
"neutral_site": true,
"parent_id": "e4986bda-2f75-4228-8295-44b2449088b1",
"track_on_court": true,
"reference": "0032300001",
"time_zones": {
"venue": "US/Eastern"
},
"venue": {
"id": "24bb478e-eb31-5f8a-8c8d-07f513169ec1",
"name": "Gainbridge Fieldhouse",
"capacity": 20000,
"address": "125 S. Pennsylvania Street",
"city": "Indianapolis",
"state": "IN",
"zip": "46204",
"country": "USA",
"sr_id": "sr:venue:6924",
"location": {
"lat": "39.763975",
"lng": "-86.15542"
}
},
"broadcasts": [
{
"network": "TNT",
"type": "TV",
"locale": "National",
"channel": "245"
},
{
"network": "TBS",
"type": "TV",
"locale": "National",
"channel": "247"
}
],
"home": {
"name": "East NBA All Stars",
"alias": "EST",
"id": "592d3144-895b-43e9-ab15-e84666a845d5",
"reference": "1610616833"
},
"away": {
"name": "West NBA All Stars",
"alias": "WST",
"id": "787ff06f-f0cc-484e-8114-04e0cdc444fa",
"reference": "1610616834"
}
},
<series id="a6c5f648-2028-457f-84cd-bf301886648c" parent_id="a8187e6d-8b68-40bc-9767-fe78cbda3311" title="NBA Finals - MIA vs DEN" round="4" start_date="2023-06-01" status="closed">
<participant name="Heat" seed="8" record="1">
<team id="583ecea6-fb46-11e1-82cb-f4ce4684ea4c" name="Heat" alias="MIA" market="Miami" reference="1610612748"/>
<source id="e75bdf18-b87a-4651-b1d6-b90a6d923ce5" title="Eastern Conference - Finals - MIA vs BOS" round="3" outcome="win"/>
</participant>
<participant name="Nuggets" seed="1" record="4">
<team id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" name="Nuggets" alias="DEN" market="Denver" reference="1610612743"/>
<source id="79030c40-c3e0-4c01-9692-af0d7ce97a45" title="Western Conference - Finals - LAL vs DEN" round="3" outcome="win"/>
</participant>
Characters Added for Player Names
| Release Date | Benefit |
|---|---|
| 09/16/2024 | Each league-specific Basketball API will now display player names containing special characters and diacritical markings. The change aims to ensure an accurate representation of a player’s given name. Going forward, player names such as Davis Bertans (id: c1bb78ed-4ce7-4e8c-b30c-06f8148d550a) will change to Dāvis Bertāns in each API endpoint.Ensure that your systems can handle these special characters and diacritics. Some examples of player names with special characters include: - Luka Dončić - Dāvis Bertāns - Ömer Aşık - Nikola Ðurišić. |
{
"id": "d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7",
"status": "ACT",
"full_name": "Luka Dončić",
"first_name": "Luka",
"last_name": "Dončić",
"abbr_name": "L.Dončić",
"height": 79,
"weight": 230,
"position": "F-G",
"primary_position": "PG",
"jersey_number": "77",
"experience": "6",
"birth_place": "Ljubljana,, SVN",
"birthdate": "1999-02-28",
"updated": "2024-09-16T12:56:48Z",
"sr_id": "sr:player:926008",
"rookie_year": 2018,
"reference": "1629029",
"draft": {
"team_id": "583ecb8f-fb46-11e1-82cb-f4ce4684ea4c",
"year": 2018,
"round": "1",
"pick": "3"
}
},
<player id="d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7" status="ACT" full_name="Luka Dončić"
first_name="Luka" last_name="Dončić" abbr_name="L.Dončić" height="79" weight="230"
position="F-G" primary_position="PG" jersey_number="77" experience="6" birth_place="Ljubljana,, SVN"
birthdate="1999-02-28" updated="2024-09-16T12:56:48Z" sr_id="sr:player:926008" rookie_year="2018"
reference="1629029">
Neutral Site Records
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 09/06/2024 | Standings | Added data points into the Standings endpoint for neutral site losses, wins, and win_pct.This will be used for the NBA In-Season Tournament. |
<league xmlns="http://feed.elasticstats.com/schema/basketball/nba/standings-v4.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
<season id="f1162fd1-29c5-4c29-abb4-57b78f16d238" year="2023" type="REG">
<conference id="7fe7e212-de01-4f8f-a31d-b9f0a95731e3" name="WESTERN CONFERENCE" alias="WESTERN">
<division id="1d29f94c-9587-494b-a232-feb20a40eb4c" name="Southwest" alias="SOUTHWEST">
<team id="583ecf50-fb46-11e1-82cb-f4ce4684ea4c" name="Mavericks" market="Dallas" wins="50" losses="32" win_pct="0.61" points_for="117.85" points_against="115.65" point_diff="2.21" sr_id="sr:team:3411" reference="1610612742">
<games-behind league="14.0" conference="7.0" division="0.0"/>
<streak>
<loss length="2"/>
</streak>
<calc_rank div_rank="1" conf_rank="5"/>
<records>
<atlantic wins="6" losses="4" win_pct="0.6"/>
<below_500 wins="27" losses="8" win_pct="0.771"/>
<central wins="3" losses="7" win_pct="0.3"/>
<conference wins="31" losses="21" win_pct="0.596"/>
<division wins="11" losses="5" win_pct="0.688"/>
<equal_rebounds wins="1" losses="1" win_pct="0.5"/>
<equal_turnovers wins="3" losses="2" win_pct="0.6"/>
<fewer_turnovers wins="30" losses="15" win_pct="0.667"/>
<home wins="25" losses="16" win_pct="0.61"/>
<last_10 wins="7" losses="3" win_pct="0.7"/>
<last_10_home wins="7" losses="3" win_pct="0.7"/>
<last_10_road wins="7" losses="3" win_pct="0.7"/>
<leads_field_goal_pct wins="37" losses="3" win_pct="0.925"/>
<leads_rebounds wins="22" losses="8" win_pct="0.733"/>
<neutral wins="0" losses="0" win_pct="0.0"/>
<northwest wins="10" losses="9" win_pct="0.526"/>
<opponent_fewer_turnovers wins="17" losses="15" win_pct="0.531"/>
<opponent_leads_field_goal_pct wins="13" losses="29" win_pct="0.31"/>
<opponent_leads_rebounds wins="27" losses="23" win_pct="0.54"/>
<opponent_scores_100_or_more wins="41" losses="32" win_pct="0.562"/>
<over_500 wins="23" losses="24" win_pct="0.489"/>
<overtime wins="1" losses="0" win_pct="1.0"/>
<pacific wins="10" losses="7" win_pct="0.588"/>
<road wins="25" losses="16" win_pct="0.61"/>
<scores_100_or_more wins="50" losses="25" win_pct="0.667"/>
<southeast wins="10" losses="0" win_pct="1.0"/>
<southwest wins="11" losses="5" win_pct="0.688"/>
<ten_points wins="31" losses="21" win_pct="0.596"/>
<three_points wins="5" losses="2" win_pct="0.714"/>
</records>
</team>
{
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"season": {
"id": "f1162fd1-29c5-4c29-abb4-57b78f16d238",
"year": 2023,
"type": "REG"
},
"conferences": [
{
"id": "7fe7e212-de01-4f8f-a31d-b9f0a95731e3",
"name": "WESTERN CONFERENCE",
"alias": "WESTERN",
"divisions": [
{
"id": "1d29f94c-9587-494b-a232-feb20a40eb4c",
"name": "Southwest",
"alias": "SOUTHWEST",
"teams": [
{
"id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Mavericks",
"market": "Dallas",
"wins": 50,
"losses": 32,
"win_pct": 0.61,
"points_for": 117.85,
"points_against": 115.65,
"point_diff": 2.21,
"sr_id": "sr:team:3411",
"reference": "1610612742",
"games_behind": {
"league": 14.0,
"conference": 7.0,
"division": 0.0
},
"streak": {
"kind": "loss",
"length": 2
},
"calc_rank": {
"div_rank": 1,
"conf_rank": 5
},
"records": [
{
"record_type": "atlantic",
"wins": 6,
"losses": 4,
"win_pct": 0.6
},
{
"record_type": "below_500",
"wins": 27,
"losses": 8,
"win_pct": 0.771
},
{
"record_type": "central",
"wins": 3,
"losses": 7,
"win_pct": 0.3
},
{
"record_type": "conference",
"wins": 31,
"losses": 21,
"win_pct": 0.596
},
{
"record_type": "division",
"wins": 11,
"losses": 5,
"win_pct": 0.688
},
{
"record_type": "equal_rebounds",
"wins": 1,
"losses": 1,
"win_pct": 0.5
},
{
"record_type": "equal_turnovers",
"wins": 3,
"losses": 2,
"win_pct": 0.6
},
{
"record_type": "fewer_turnovers",
"wins": 30,
"losses": 15,
"win_pct": 0.667
},
{
"record_type": "home",
"wins": 25,
"losses": 16,
"win_pct": 0.61
},
{
"record_type": "last_10",
"wins": 7,
"losses": 3,
"win_pct": 0.7
},
{
"record_type": "last_10_home",
"wins": 7,
"losses": 3,
"win_pct": 0.7
},
{
"record_type": "last_10_road",
"wins": 7,
"losses": 3,
"win_pct": 0.7
},
{
"record_type": "leads_field_goal_pct",
"wins": 37,
"losses": 3,
"win_pct": 0.925
},
{
"record_type": "leads_rebounds",
"wins": 22,
"losses": 8,
"win_pct": 0.733
},
{
"record_type": "neutral",
"wins": 0,
"losses": 0,
"win_pct": 0.0
},
{
"record_type": "northwest",
"wins": 10,
"losses": 9,
"win_pct": 0.526
},
{
"record_type": "opponent_fewer_turnovers",
"wins": 17,
"losses": 15,
"win_pct": 0.531
},
{
"record_type": "opponent_leads_field_goal_pct",
"wins": 13,
"losses": 29,
"win_pct": 0.31
},
{
"record_type": "opponent_leads_rebounds",
"wins": 27,
"losses": 23,
"win_pct": 0.54
},
{
"record_type": "opponent_scores_100_or_more",
"wins": 41,
"losses": 32,
"win_pct": 0.562
},
{
"record_type": "overtime",
"wins": 1,
"losses": 0,
"win_pct": 1.0
},
{
"record_type": "over_500",
"wins": 23,
"losses": 24,
"win_pct": 0.489
},
{
"record_type": "pacific",
"wins": 10,
"losses": 7,
"win_pct": 0.588
},
{
"record_type": "road",
"wins": 25,
"losses": 16,
"win_pct": 0.61
},
{
"record_type": "scores_100_or_more",
"wins": 50,
"losses": 25,
"win_pct": 0.667
},
{
"record_type": "southeast",
"wins": 10,
"losses": 0,
"win_pct": 1.0
},
{
"record_type": "southwest",
"wins": 11,
"losses": 5,
"win_pct": 0.688
},
{
"record_type": "ten_points",
"wins": 31,
"losses": 21,
"win_pct": 0.596
},
{
"record_type": "three_points",
"wins": 5,
"losses": 2,
"win_pct": 0.714
}
]
},
Play-in Berth Clinch Status
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 08/22/2024 | Rankings | We've added a new clinched play_in_berth status to the Rankings endpoint.This status denotes a team has secured at least the play-in game. |
<conference id="3960cfac-7361-4b30-bc25-8d393de6f62f" name="EASTERN CONFERENCE" alias="EASTERN">
<division id="582d6502-9a93-4a8d-8785-69374d732875" name="Atlantic" alias="ATLANTIC">
<team id="583eccfa-fb46-11e1-82cb-f4ce4684ea4c" name="Celtics" market="Boston" sr_id="sr:team:3422" reference="1610612738">
<rank conference="1" division="1" clinched="conference"/>
</team>
<team id="583ec70e-fb46-11e1-82cb-f4ce4684ea4c" name="Knicks" market="New York" sr_id="sr:team:3421" reference="1610612752">
<rank conference="2" division="2" clinched="playoff_berth"/>
</team>
<team id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" name="76ers" market="Philadelphia" sr_id="sr:team:3420" reference="1610612755">
<rank conference="7" division="3" clinched="play_in_berth"/>
</team>
<team id="583ec9d6-fb46-11e1-82cb-f4ce4684ea4c" name="Nets" market="Brooklyn" sr_id="sr:team:3436" reference="1610612751">
<rank conference="11" division="4" clinched="eliminated"/>
</team>
<team id="583ecda6-fb46-11e1-82cb-f4ce4684ea4c" name="Raptors" market="Toronto" sr_id="sr:team:3433" reference="1610612761">
<rank conference="12" division="5" clinched="eliminated"/>
</team>
Added Language Translations
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 06/11/2024 | All feeds with teams, players, and play-by-play descriptions. | We added language translations for all feeds with teams, players, and play-by-play descriptions. The following languages are now available: - Brazilian Portuguese - English - French - Russian - Simplified Chinese - Spanish |
TBD vs. TBD Support
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 04/11/2024 | Daily Schedule Schedule Series Schedule | We are introducing support for Team TBD as a placeholder team.This means you will now be able to obtain scheduled future games with known dates, even when one or both participants are yet to be determined. See below for sample data. |
<league xmlns="http://feed.elasticstats.com/schema/basketball/schedule-v5.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
<season-schedule id="851f97e4-c830-4590-88e9-e1286383148c" year="2023" type="PIT">
<series id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
<games>
<game id="adafa13c-68d5-4127-bad0-48f46dc3485d" status="time-tbd" coverage="full" scheduled="2024-04-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>
</games>
</series>
<series id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
<games>
<game id="34fbb07b-8985-45e8-b0e0-00a717230b90" status="time-tbd" coverage="full" scheduled="2024-04-16T17: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="6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a" title="Western Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
<participant name="Western Conference - Play-in Round - #8 vs #7" record="0">
<source id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
</participant>
<participant name="Western Conference - Play-in Round - #10 vs #9" record="0">
<source id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
</participant>
<games>
<game id="75da7f44-61fd-4590-b97a-074d863b20a7" status="time-tbd" coverage="full" scheduled="2024-04-19T17: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="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
<games>
<game id="658de491-08be-4279-a8a7-6f98f1637e70" status="time-tbd" coverage="full" scheduled="2024-04-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>
</games>
</series>
<series id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
<games>
<game id="bd80d85f-28e4-4ae9-8dea-97b14951e8c2" status="time-tbd" coverage="full" scheduled="2024-04-16T17: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="ec633fa3-3c1c-4560-98ac-5f75850d70e1" title="Eastern Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
<participant name="Eastern Conference - Play-in Round - #8 vs #7" record="0">
<source id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
</participant>
<participant name="Eastern Conference - Play-in Round - #10 vs #9" record="0">
<source id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
</participant>
<games>
<game id="b1c9bbbe-feb8-43e8-8226-4df5f013c0ff" status="time-tbd" coverage="full" scheduled="2024-04-19T17: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>
</season-schedule>
</league>
{
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"season": {
"id": "851f97e4-c830-4590-88e9-e1286383148c",
"year": 2023,
"type": "PIT"
},
"series": [
{
"id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
"title": "Eastern Conference - Play-in Round - #10 vs #9",
"round": 1,
"start_date": "2024-04-17",
"status": "scheduled",
"participants": [],
"games": [
{
"id": "adafa13c-68d5-4127-bad0-48f46dc3485d",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-04-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": "6171e123-afe8-4c67-b198-a33a29e7a572",
"title": "Western Conference - Play-in Round - #8 vs #7",
"round": 1,
"start_date": "2024-04-16",
"status": "scheduled",
"participants": [],
"games": [
{
"id": "34fbb07b-8985-45e8-b0e0-00a717230b90",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-04-16T17: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": "6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a",
"title": "Western Conference - Play-in Round - TBD vs TBD",
"round": 1,
"start_date": "2024-04-19",
"status": "scheduled",
"participants": [
{
"name": "Western Conference - Play-in Round - #8 vs #7",
"record": 0,
"source": {
"id": "6171e123-afe8-4c67-b198-a33a29e7a572",
"title": "Western Conference - Play-in Round - #8 vs #7",
"round": 1,
"outcome": "loss"
}
},
{
"name": "Western Conference - Play-in Round - #10 vs #9",
"record": 0,
"source": {
"id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
"title": "Western Conference - Play-in Round - #10 vs #9",
"round": 1,
"outcome": "win"
}
}
],
"games": [
{
"id": "75da7f44-61fd-4590-b97a-074d863b20a7",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-04-19T17: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": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
"title": "Western Conference - Play-in Round - #10 vs #9",
"round": 1,
"start_date": "2024-04-17",
"status": "scheduled",
"participants": [],
"games": [
{
"id": "658de491-08be-4279-a8a7-6f98f1637e70",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-04-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": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
"title": "Eastern Conference - Play-in Round - #8 vs #7",
"round": 1,
"start_date": "2024-04-16",
"status": "scheduled",
"participants": [],
"games": [
{
"id": "bd80d85f-28e4-4ae9-8dea-97b14951e8c2",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-04-16T17: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": "ec633fa3-3c1c-4560-98ac-5f75850d70e1",
"title": "Eastern Conference - Play-in Round - TBD vs TBD",
"round": 1,
"start_date": "2024-04-19",
"status": "scheduled",
"participants": [
{
"name": "Eastern Conference - Play-in Round - #8 vs #7",
"record": 0,
"source": {
"id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
"title": "Eastern Conference - Play-in Round - #8 vs #7",
"round": 1,
"outcome": "loss"
}
},
{
"name": "Eastern Conference - Play-in Round - #10 vs #9",
"record": 0,
"source": {
"id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
"title": "Eastern Conference - Play-in Round - #10 vs #9",
"round": 1,
"outcome": "win"
}
}
],
"games": [
{
"id": "b1c9bbbe-feb8-43e8-8226-4df5f013c0ff",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-04-19T17: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"
}
}
]
}
]
}
Play-In Tournament Bracket
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 04/09/2024 | Series Schedule | Added Play-In Tournament data to the Series Schedule endpoint. You may now make use of this endpoint to easily build out a bracket for the Play-in Tournament. Ex. https://api.sportradar.com/nba/trial/v8/en/series/2023/PIT/schedule.json |
<league xmlns="http://feed.elasticstats.com/schema/basketball/schedule-v5.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
<season-schedule id="851f97e4-c830-4590-88e9-e1286383148c" year="2023" type="PIT">
<series id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
<games>
</games>
</series>
<series id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
<games>
</games>
</series>
<series id="6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a" title="Western Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
<participant name="Western Conference - Play-in Round - #8 vs #7" record="0">
<source id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
</participant>
<participant name="Western Conference - Play-in Round - #10 vs #9" record="0">
<source id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
</participant>
<games>
</games>
</series>
<series id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
<games>
</games>
</series>
<series id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
<games>
</games>
</series>
<series id="ec633fa3-3c1c-4560-98ac-5f75850d70e1" title="Eastern Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
<participant name="Eastern Conference - Play-in Round - #8 vs #7" record="0">
<source id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
</participant>
<participant name="Eastern Conference - Play-in Round - #10 vs #9" record="0">
<source id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
</participant>
<games>
</games>
</series>
</season-schedule>
</league>
{
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"season": {
"id": "851f97e4-c830-4590-88e9-e1286383148c",
"year": 2023,
"type": "PIT"
},
"series": [
{
"id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
"title": "Eastern Conference - Play-in Round - #10 vs #9",
"round": 1,
"start_date": "2024-04-17",
"status": "scheduled",
"participants": [],
"games": []
},
{
"id": "6171e123-afe8-4c67-b198-a33a29e7a572",
"title": "Western Conference - Play-in Round - #8 vs #7",
"round": 1,
"start_date": "2024-04-16",
"status": "scheduled",
"participants": [],
"games": []
},
{
"id": "6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a",
"title": "Western Conference - Play-in Round - TBD vs TBD",
"round": 1,
"start_date": "2024-04-19",
"status": "scheduled",
"participants": [
{
"name": "Western Conference - Play-in Round - #8 vs #7",
"record": 0,
"source": {
"id": "6171e123-afe8-4c67-b198-a33a29e7a572",
"title": "Western Conference - Play-in Round - #8 vs #7",
"round": 1,
"outcome": "loss"
}
},
{
"name": "Western Conference - Play-in Round - #10 vs #9",
"record": 0,
"source": {
"id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
"title": "Western Conference - Play-in Round - #10 vs #9",
"round": 1,
"outcome": "win"
}
}
],
"games": []
},
{
"id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
"title": "Western Conference - Play-in Round - #10 vs #9",
"round": 1,
"start_date": "2024-04-17",
"status": "scheduled",
"participants": [],
"games": []
},
{
"id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
"title": "Eastern Conference - Play-in Round - #8 vs #7",
"round": 1,
"start_date": "2024-04-16",
"status": "scheduled",
"participants": [],
"games": []
},
{
"id": "ec633fa3-3c1c-4560-98ac-5f75850d70e1",
"title": "Eastern Conference - Play-in Round - TBD vs TBD",
"round": 1,
"start_date": "2024-04-19",
"status": "scheduled",
"participants": [
{
"name": "Eastern Conference - Play-in Round - #8 vs #7",
"record": 0,
"source": {
"id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
"title": "Eastern Conference - Play-in Round - #8 vs #7",
"round": 1,
"outcome": "loss"
}
},
{
"name": "Eastern Conference - Play-in Round - #10 vs #9",
"record": 0,
"source": {
"id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
"title": "Eastern Conference - Play-in Round - #10 vs #9",
"round": 1,
"outcome": "win"
}
}
],
"games": []
}
]
}
Player Preseason Stats
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 02/08/2024 | Player Profile | Added preseason and postseason statistics to player profiles. |
Player Statuses
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 01/03/2024 | Player Profile Team Profile | Added two new player statuses: - DUP - Duplicate- M-LEAGUE - Sent to minor league team |
Technical Foul Update
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 12/19/2023 | Game Boxscore Game Summary League Leaders Play-by-Play Player Profile Push Events Push Statistics Seasonal Statistics Series Statistics Splits | Added support for non-unsportsmanlike technical fouls to accurately reflect the number of technicals that lead to a player ejection. This update includes: - A new event_type of technicalfoulnonunsportsmanlike in the Play-by-Play endpoint.- A tech_fouls_non_unsportsmanlike player attribute at the game and season level. This attribute will account for non-unsportsmanlike technical fouls and will be handled in the same manner as the existing tech_fouls attribute within the API. |
In-Season Tournament
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/17/2023 | Schedule & Game Endpoints | Added support for the new In-Season Tournament. In-Season Tournament games will fall within the new IST season parameter and appear in the regular season schedule with a inseason_tournament=true attribute included. |
New Shot Type Descriptions
| Release Date | Feeds Affected | Benefit |
| 11/10/2022 | Play-by-Play | Added several new shot type descriptions (shot_type_desc) for all games in the Play-by-Play endpoint. For a complete list of the new descriptions please see our FAQs. |
Draft Endpoints Added
| Release Date | Feeds Affected | Benefit |
| 04/11/2019 | Draft Summary Prospects Team Draft Summary Top Prospects Trades Push Draft Summary | New feeds added to support draft information. |
Sportradar IDs
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | All | Added SR IDs for games, venues, teams, and players. |
Sportradar IDs
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | All | Added SR IDs for games, venues, teams, and players. |
Broadcast Info
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | Daily Schedule Schedule Series Schedule | Added broadcast channel, locale, and type. |
Timezone Info
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | Daily Schedule Game Boxscore Game Summary Play-by-Play Schedule Series Schedule Push Clock Push Events Push Statistics | Added time zone information for the venue, away and home teams. |
Jersey Numbers in Free Agents Endpoint
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | Free Agents | Added jersey numbers for players. |
New Standings Data
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | Standings | Added wins, losses, and winning percentage for the following standings categories: equal rebounds, equal turnovers, fewer turnovers, leads field goal percentage, leads rebounds, opponent fewer turnovers, opponent leads field goal percentage, opponent leads rebounds, opponent scores 100 or more, and scores 100 or more. |
Splits Endpoints
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | Splits | Added 4 endpoints of splits (Game, Hierarchy, In-game, and Schedule). |
API Release
| Release Date | Feeds Affected | Benefit |
| 06/22/2018 | All | Initial release for NBA API v5. |