Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Sport Competition Mappings

Get competition mappings for a sport.
Returns mappings between external IDs and Sportradar competition/tournament IDs.
Only returns competitions from providers configured for the API key.

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

Update Frequency

TTL / Cache: 5 minutes

Data Updates: As mappings are added or corrected

Cache behavior and refresh guidance: Mapping API Basics

📘

Resolving IDs Across Products

Learn how to use the Sport Competition Mappings feed to resolve competition IDs between Sportradar products in our Resolving IDs Across Products integration scenario.


Data Points

Competition
AttributeParent ElementTypeDescription
idcompetitionStringSportradar ID of a competition

ex. sr:tournament:17
Mapping

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

AttributeParent ElementTypeDescription
bookmaker_idcompetition - mappingStringMapping entity ID

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

ex. sr:book:10358
external_idcompetition - 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:sport:\d+$

Unique Id of a sport

Example: sr:sport: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 results to return

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Bad Request - Invalid sport ID format

404

Not Found - Sport 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