Get season mappings for a competition.
Returns mappings between external IDs and Sportradar season IDs.
Only returns seasons from providers configured for the API key.
Results are paginated by seasons (not individual mappings).
Seasons are sorted alphabetically by ID.
Mappings within each season are sorted by bookmaker_id, then external_id.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Update FrequencyTTL / Cache: 5 minutes
Data Updates: As mappings are added or corrected
Cache behavior and refresh guidance: Mapping API Basics
Resolving IDs Across ProductsLearn how to use the Competition Season Mappings feed to resolve season IDs between Sportradar products in our Resolving IDs Across Products integration scenario.
Data Points
Season
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | season | String | Sportradar ID of a season ex. sr:season:60490 |
Mapping
See our ID Types section for more context on Sportradar ID types
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
bookmaker_id | season - mapping | String | Mapping entity IDsr:book:10358 represents Sportradar's UUIDs. Additional entities (or ID systems) can be configuredex. sr:book:10358 |
external_id | season - mapping | String | External ID in the mapping entity's system ex. 4353138d-4c22-4396-95d8-5f587d2df25c |
Bad Request - Invalid competition ID format
Not Found - Competition does not exist