Docs
Coverage MatrixDocumentationRelease LogLog InContact Us

Find all updates to the NBA v5 API and its documentation

Added Language Translations

Release DateFeeds AffectedBenefit
06/11/2024All 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 DateFeeds AffectedBenefit
04/11/2024Daily 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 DateFeeds AffectedBenefit
04/09/2024Series ScheduleAdded 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 DateFeeds AffectedBenefit
02/08/2024Player ProfileAdded preseason and postseason statistics to player profiles.


Player Statuses

Release DateFeeds AffectedBenefit
01/03/2024Player Profile

Team Profile
Added two new player statuses:

- DUP - Duplicate

- M-LEAGUE - Sent to minor league team

Technical Foul Update

Release DateFeeds
Affected
Benefit
12/19/2023Game 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 DateFeeds AffectedBenefit
10/17/2023Schedule &
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 DateFeeds AffectedBenefit
11/10/2022Play-by-PlayAdded 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 DateFeeds AffectedBenefit
04/11/2019Draft Summary
Prospects
Team Draft Summary
Top Prospects
Trades
Push Draft Summary
New feeds added to support draft information.

Sportradar IDs

Release DateFeeds AffectedBenefit
06/22/2018AllAdded SR IDs for games, venues, teams, and players.

Sportradar IDs

Release DateFeeds AffectedBenefit
06/22/2018AllAdded SR IDs for games, venues, teams, and players.

Broadcast Info

Release DateFeeds AffectedBenefit
06/22/2018Daily Schedule
Schedule
Series Schedule
Added broadcast channel, locale, and type.

Timezone Info

Release DateFeeds AffectedBenefit
06/22/2018Daily 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 DateFeeds AffectedBenefit
06/22/2018Free AgentsAdded jersey numbers for players.

New Standings Data

Release DateFeeds AffectedBenefit
06/22/2018StandingsAdded 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 DateFeeds AffectedBenefit
06/22/2018SplitsAdded 4 endpoints of splits (Game, Hierarchy, In-game, and Schedule).

API Release

Release DateFeeds AffectedBenefit
06/22/2018AllInitial release for NBA API v5.