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:
| Entity | Prefix | Example |
|---|---|---|
| Game | sr:match: | sr:match:43065571 |
| Team (NBA, WNBA) | sr:team: | sr:team:3426 |
| Team (NCAA MB, NCAA WB) | sr:competitor: | sr:competitor:101873 |
| Player | sr:player: | sr:player:608000 |
| Venue | sr: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_idtogether on each record. - Keep the UUID as the primary identifier.
sr_idis 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 usesr:competitor:in game-context payloads. - Replace Mapping API lookups for basketball joins with the
sr_idreturned directly on the feed, if your integration currently uses them.
🔢 Products
| Sport | Product | Version(s) |
|---|---|---|
| Basketball | NBA API | v8, v7, v5 |
| Basketball | WNBA API | v8, v7, v4 |
| Basketball | NCAA Men's Basketball API | v8, v7, v4 |
| Basketball | NCAA Women's Basketball API | v8, 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 & 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>