GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NBA & WNBA APIs – Ranking Info added to Standings Endpoint

We've added ranking information to the NBA and WNBA Standings endpoints.

This includes each team's rank in their conference, their division (NBA only), and their playoff clinch status.

Each team now includes a rank element (a rank object in JSON) with the following fields:

  • conference — the team's rank within its conference.
  • division — the team's rank within its division (NBA only; not present for the WNBA).
  • clinched — the team's playoff clinch status, if any (for example, conference or playoff_berth). The field is only present once a team has clinched; teams that have not yet clinched will not include it.

See our NBA FAQ or WNBA FAQ for a complete list of valid clinched statuses.


Benefit

These data points were previously only available in the Rankings endpoints for each API. The addition to the Standings endpoints allows you to more efficiently access ranking and playoff clinching statuses for all teams in the NBA and WNBA.


📋 Recommended Actions

  • Read the new rank element from the Standings endpoints to retrieve conference rank, division rank (NBA), and clinch status in a single call.
  • If you currently pull this data from the Rankings endpoints, consider consolidating to Standings to reduce the number of API calls.
  • Handle the clinched field as optional, since it is only present once a team has clinched a playoff position.
  • Account for division being available for the NBA only, not the WNBA.

☑️ Sample Requests:

NBA Standings

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

WNBA Standings

curl --request GET \
     --url https://api.sportradar.com/wnba/trial/v8/en/seasons/2025/REG/standings.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
BasketballNBA APIv8
BasketballWNBA APIv8

🔁 Endpoints Affected


⚙️ Return Samples

<team id="583ec928-fb46-11e1-82cb-f4ce4684ea4c" name="Pistons" market="Detroit" wins="60" losses="22" win_pct="0.732" points_for="117.77" points_against="109.61" point_diff="8.16" sr_id="sr:team:3424" reference="1610612765">
    <rank conference="1" division="1" clinched="conference"/>
    <records>
    ...
"teams": [
    {
        "id": "171b097d-01db-4ae8-9d56-035689402ec6",
        "name": "Aces",
        "market": "Las Vegas",
        "wins": 34,
        "losses": 6,
        "win_pct": 0.85,
        "points_for": 92.83,
        "points_against": 80.28,
        "point_diff": 12.55,
        "sr_id": "sr:team:35550",
        "rank": {
            "conference": 1,
            "clinched": "playoff_berth"
        },
    ...