GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NBA API - Postseason Clinch Status

We’ve added a postseason_berth enum clinched status to our NBA Rankings endpoint.

This status applies when a team has clinched postseason participation (guaranteed top 10 seed), but has not yet secured either a playoff berth (top 6) or a locked play-in position (7–10).

View our complete list of clinched playoff values to review all supported clinched statuses and update your polling logic, if necessary.


Benefit

Identify and display all postseason qualification scenarios, including transitional cases between playoff and Play-In qualification, in your NBA standings and rankings.


☑️ Sample Requests:

NBA Rankings

curl --request GET \
     --url https://api.sportradar.com/nba/trial/v8/en/seasons/{season_year}/REG/rankings.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Versions


🔁 Affected Endpoints


⚙️ Return Samples

Example of a team (76ers) that has secured a postseason berth, but not yet finalized playoff or play-in seeding:

        <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="2" division="1" clinched="division_playoff_berth"/>
                </team>
                <team id="583ec70e-fb46-11e1-82cb-f4ce4684ea4c" name="Knicks" market="New York" sr_id="sr:team:3421" reference="1610612752">
                    <rank conference="3" division="2" clinched="playoff_berth"/>
                </team>
                <team id="583ecda6-fb46-11e1-82cb-f4ce4684ea4c" name="Raptors" market="Toronto" sr_id="sr:team:3433" reference="1610612761">
                    <rank conference="5" division="3" 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="4" clinched="postseason_berth"/>
                </team>
                <team id="583ec9d6-fb46-11e1-82cb-f4ce4684ea4c" name="Nets" market="Brooklyn" sr_id="sr:team:3436" reference="1610612751">
                    <rank conference="13" division="5" clinched="eliminated"/>
                </team>
            </division>