GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Basketball APIs – Sportradar Ids Added to Feeds

We've added an sr_id field to several US Basketball APIs — a Sportradar global ID returned alongside the existing UUID.

Previously, basketball records carried only a Sportradar UUID, with no direct crosswalk to Sportradar's global ID system. Matching entities across these APIs and other Sportradar products (Global Basketball, the Odds APIs, and so on) required a Mapping API lookup. sr_id is now returned for current and historical seasons, so existing games, teams, players and venues can be matched — not just new ones.

The sr_id format depends on entity type:

EntityPrefixExample
Gamesr:match:sr:match:43065571
Team (NBA, WNBA)sr:team:sr:team:3426
Team (NCAA MB, NCAA WB)sr:competitor:sr:competitor:101873
Playersr:player:sr:player:608000
Venuesr:venue:sr:venue:6930
📌

A small number of records may return without sr_id — for example, a cancelled game, or a future game that does not yet have a confirmed start time. UUIDs remain available on all records.


⭐ Benefit

Join basketball records to Sportradar's global ID system — the Odds APIs, Global products, and other sr_id integrations — by reading the value directly from the feed, without an extra Mapping API call.


📋 Recommended Actions

  • Store the UUID and sr_id together on each record.
  • Keep the UUID as the primary identifier. sr_id is a supplementary crosswalk.
  • Use the prefix that matches each entity type (see table above). Teams in NBA and WNBA use sr:team:; teams in NCAA MB and NCAA WB use sr:competitor: in game-context payloads.
  • Replace Mapping API lookups for basketball joins with the sr_id returned directly on the feed, if your integration currently uses them.

🔢 Products

SportProductVersion(s)
BasketballNBA APIv8, v7, v5
BasketballWNBA APIv8, v7, v4
BasketballNCAA Men's Basketball APIv8, v7, v4
BasketballNCAA Women's Basketball APIv8, v7, v3

🔁 Endpoints Affected

Every endpoint across the NBA, WNBA, NCAA MB, and NCAA WB APIs that returns games, teams, players, or venues now includes sr_id next to the UUID. Representative endpoints include:

  • Schedule
  • Game Boxscore
  • Game Summary
  • Play-by-Play
  • Team Profile
  • Player Profile

☑️ Sample Request:

Game Summary — Minnesota Timberwolves vs. Milwaukee Bucks — NBA API

curl --request GET \
     --url https://api.sportradar.com/nba/trial/v8/en/games/f5b69d89-bde3-4b4d-91c4-c18c7cd43aaa/summary.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

⚙️ Return Samples

    "id": "f5b69d89-bde3-4b4d-91c4-c18c7cd43aaa",
    "status": "closed",
    "scheduled": "2026-11-03T01:00:00+00:00",
    "sr_id": "sr:match:73719500",
    "season": {
        "id": "593a6087-97e0-4737-adb5-250d09dd9a75",
        "year": 2026,
        "type": "REG",
        "name": "Regular Season"
    },
    "venue": {
        "id": "7aed802e-3562-5b73-af1b-3859529f9b95",
        "name": "Target Center",
        "city": "Minneapolis",
        "state": "MN",
        "sr_id": "sr:venue:6930"
    },
    "home": {
        "name": "Timberwolves",
        "market": "Minnesota",
        "alias": "MIN",
        "id": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3426",
        "points": 112,
        "players": [
            {
                "full_name": "Zyon Pullin",
                "jersey_number": "15",
                "id": "0a5e8d12-47e5-4afc-973a-e1f8184776c1",
                "sr_id": "sr:player:1938700"
            }
            ... (additional players)
        ]
    },
    "away": {
        "name": "Bucks",
        "market": "Milwaukee",
        "alias": "MIL",
        "id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
        "sr_id": "sr:team:3410",
        "points": 100
    }
    ...
{
    "id": "2d21f497-2795-432d-b254-5ae9fbbd0096",
    "status": "ACT",
    "full_name": "Caitlin Clark",
    "jersey_number": "22",
    "sr_id": "sr:player:2104684",
    "league": {
        "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
        "name": "WNBA",
        "alias": "WNBA"
    },
    "team": {
        "id": "f073a15f-0486-4179-b0a3-dfd0294eb595",
        "name": "Fever",
        "market": "Indiana",
        "alias": "IND",
        "sr_id": "sr:team:3452"
    }
    ...
}
<league id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM">
    <daily-schedule date="2026-11-02">
        <games>
            <game id="daf358c9-bdb2-4b6e-a20b-726b959a8182" status="closed" scheduled="2026-11-02T05:00:00+00:00" home_points="57" away_points="72" sr_id="sr:match:73658208">
                <season id="c000147f-6286-4eab-a89b-4c501661188f" year="2026" type="REG" name="Regular Season"/>
                <venue id="cc0e4ca5-7d8d-4b10-803c-5b48b9118770" name="Rock Hill Sports &amp; Event Center" city="Rock Hill" state="SC" sr_id="sr:venue:61581"/>
                <home name="Liberty Flames" alias="LIB" id="559db90c-741f-40d1-aa81-3fdd1d4889f3" sr_id="sr:competitor:101873"/>
                <away name="High Point Panthers" alias="HP" id="a311188e-1259-4fda-b0ea-c47cb52694b1" sr_id="sr:competitor:89120"/>
            </game>
            ... (additional games)
        </games>
    </daily-schedule>
</league>
<game id="faf3c497-83cc-4957-872a-bacab1ef77f3" status="closed" scheduled="2026-11-02T17:00:00+00:00" sr_id="sr:match:73716458">
    <season id="fcc15081-4c8b-4787-a6d2-f4ab60746caa" year="2026" type="REG" name="Regular Season"/>
    <home name="Gamecocks" alias="SCAR" market="South Carolina" id="7f4f0451-6b78-4082-9503-ce851e549b0c" points="101" sr_id="sr:competitor:198334"/>
    <away name="Terrapins" alias="MD" market="Maryland" id="c612ba6e-aa21-48f8-a5d8-0a9e0a9c3320" points="93" sr_id="sr:competitor:198336"/>
    <quarter number="1">
        <events>
            <event clock="9:50" event_type="freethrowmade" attempt="1 of 2">
                <description>Chloe Kitts makes regular free throw 1 of 2</description>
                <statistics>
                    <freethrow made="true" free_throw_type="regular" points="1">
                        <team name="Gamecocks" market="South Carolina" id="7f4f0451-6b78-4082-9503-ce851e549b0c" sr_id="sr:competitor:198334"/>
                        <player full_name="Chloe Kitts" jersey_number="21" id="57a1335c-58f1-4f42-b51f-f3d498dd86dc" sr_id="sr:player:2526971"/>
                    </freethrow>
                </statistics>
            </event>
            ... (additional events)
        </events>
    </quarter>
</game>