Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Competition Season Mappings

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

300s Time To Live / Cache


Data Points

Season
AttributeParent ElementTypeDescription
idseasonStringSportradar ID of a season

ex. sr:season:60490
Mapping

See our ID Types section for more context on Sportradar ID types

AttributeParent ElementTypeDescription
bookmaker_idseason - mappingStringMapping entity ID

sr:book:10358 represents Sportradar's UUIDs. Additional entities (or ID systems) can be configured

ex. sr:book:10358
external_idseason - mappingStringExternal ID in the mapping entity's system

ex. 4353138d-4c22-4396-95d8-5f587d2df25c

Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
required
^sr:competition:\d+$

Unique Id of a competition

Example: sr:competition:x

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Query Params
integer
≥ 0
Defaults to 0

Starting position for pagination

integer
1 to 100
Defaults to 100

Maximum number of seasons to return per page

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Bad Request - Invalid competition ID format

404

Not Found - Competition does not exist

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json