Find all updates to Mapping v2
Mapping API Release
🗓️ Release Date 04/07/2026
We’ve released our Sportradar Mapping API!
⭐ Benefit
The Mapping API allows you to translate between Sportradar’s two ID systems, including SR IDs (for example, sr:season:xxxx) and Sportradar UUIDs (for example, xxxxxxx-xxxxxxxx-xxxxxxxxxx). It can also support mappings to select external provider IDs.
Rather than consuming large, paginated mapping feeds, the Mapping API provides targeted, entity-level lookups. Submit a supported ID and retrieve its corresponding ID in another supported system. This streamlined approach makes it easier to connect data across Sportradar products and simplify ID reconciliation in your workflows.
☑️ Sample Requests:
- Sport Competition Mappings -
https://api.sportradar.com/mapping/trial/v2/en/sports/:sport_id/competition_mappings.json - Season Player Mappings -
https://api.sportradar.com/mapping/trial/v2/en/seasons/:season_id/player_mappings.json
⚙️ Return Samples
<season_player_mappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2026-04-02T15:29:20+00:00" xmlns="http://schemas.sportradar.com/sportsapi/mapping/v2" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/mapping/v2 https://schemas.sportradar.com/sportsapi/mapping/v2/schemas/season_player_mappings.xsd">
<player id="sr:player:608020">
<mappings>
<mapping bookmaker_id="sr:book:10358" external_id="5e5099d1-4a58-43f2-8d03-f2ae5dd49337"/>
</mappings>
</player>
<player id="sr:player:607468">
<mappings>
<mapping bookmaker_id="sr:book:10358" external_id="f2625432-3903-4f90-9b0b-2e4f63856bb0"/>
</mappings>
</player>
<player id="sr:player:607336">
<mappings>
<mapping bookmaker_id="sr:book:10358" external_id="6c60282d-165a-4cba-8e5a-4f2d9d4c5905"/>
</mappings>
</player>
<player id="sr:player:852170">
<mappings>
<mapping bookmaker_id="sr:book:10358" external_id="31baa84f-c759-4f92-8e1f-a92305ade3d6"/>
<mapping bookmaker_id="sr:book:10358" external_id="af5417ae-7d9a-4ffd-925e-74d914396f67"/>
</mappings>
</player>{
"generated_at": "2026-04-02T20:42:15+00:00",
"players": [
{
"id": "sr:player:608020",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "5e5099d1-4a58-43f2-8d03-f2ae5dd49337"
}
]
},
{
"id": "sr:player:607468",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "f2625432-3903-4f90-9b0b-2e4f63856bb0"
}
]
},
{
"id": "sr:player:607336",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "6c60282d-165a-4cba-8e5a-4f2d9d4c5905"
}
]
},
{
"id": "sr:player:852170",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "31baa84f-c759-4f92-8e1f-a92305ade3d6"
},
{
"bookmaker_id": "sr:book:10358",
"external_id": "af5417ae-7d9a-4ffd-925e-74d914396f67"
}
]
},
{
"id": "sr:player:607528",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "bf9ad0fd-0cb8-4360-8970-5f1b5cf3fa8d"
}
]
},
{
"id": "sr:player:996297",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "453b7277-cb31-4dd1-8b3b-46acbd8bb24d"
},
{
"bookmaker_id": "sr:book:10358",
"external_id": "ffc5579c-783f-4d62-80ab-3c3dcb05a27d"
}
]
},
{
"id": "sr:player:996299",
"mappings": [
{
"bookmaker_id": "sr:book:10358",
"external_id": "685576ef-ea6c-4ccf-affd-18916baf4e60"
},
{
"bookmaker_id": "sr:book:10358",
"external_id": "f4308a07-050d-4836-846c-737926b187d4"
}
]
},