Competitor Mappings

get https://api.sportradar.com/oddscomparison-prematch/{access_level}/v2/{language_code}/competitors/mappings.{format}

Provides competitor ID mapping between League Specific and General Sport ID types.

⏱️
Update Frequency
600s Time To Live / Cache

Data Points

Competitor:

Attribute	Parent Element	Type	Description
`abbreviation`	`sport_event` - `competitors` - `competitor`	String	Abbreviated name of a competitor ex. `LOS` (Los Angeles Dodgers) or `HAA` (Haaland, Erling Braut)
`age_group`	`sport_event` - `competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`sport_event` - `competitors` - `competitor`	String	Country name of a competitor ex. `USA`
`country_code`	`sport_event` - `competitors` - `competitor`	String	Country code of a competitor ex. `USA`
`gender`	`sport_event` - `competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`sport_event` - `competitors` - `competitor`	String	Unique SR ID of a competitor ex. `sr:competitor:3638` Click here for more info on Sportradar IDs
`name`	`sport_event` - `competitors` - `competitor`	String	Name of a competitor ex. `Los Angeles Dodgers` or `Haaland, Erling Braut`
`qualifier`	`sport_event` - `competitors` - `competitor`	String	Signifies a competitor as the home or away team ex. `home`, `away`
`rotation_number`	`sport_event` - `competitors` - `competitor`	Integer	Rotation number of a competitor bet ex. `930`

Sport Event:

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique SR ID of a sport event ex. `sr:sport_event:47395897`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:47395897`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Market:

Attribute	Parent Element	Type	Description
`id`	`market`	GUID	Unique ID of a market ex. `sr:market:1`
`is_live`	`market`	Boolean	Signifies a market's sport event is live when `true`
`name`	`market`	String	Name of a market. Click here for a complete list of available markets and their IDs ex. `2way`, `3way`, `total`, `run_line`, `handicap`, `asian_handicap`, `first_team_to_score`, `1x2_half_time`

Books:

Attribute	Parent Element	Type	Description
`external_market_id`	`market` - `book`	GUID	Unique market ID used by the bookmaker. Leverage this ID to create deeplinking ex. `16243440`
`external_sport_event_id`	`market` - `book`	GUID	Unique sport event ID used by the bookmaker. Leverage this ID to create deeplinking ex. `1159662682`
`id`	`market` - `book`	GUID	Unique ID of a sportsbook for a market ex. `sr:book:18186`
`name`	`market` - `book`	String	Name of a sportsbook for a market ex. `FanDuel`
`removed`	`market` - `book`	String	Signifies a book market has been removed when `true`

Market Outcome:

Attribute	Parent Element	Type	Description
`external_outcome_id`	`market` - `book` - `outcome`	GUID	Unique outcome ID used by the bookmaker. Leverage this ID to create deeplinking ex. `0QA221647684#87306987_13L88808Q1929653Q21`
`field_id`	`market` - `book` - `outcome`	GUID	Identifier for the ouctome type ex. `1` & `2` for `home` & `away`. `3`, `4`, & `5` for `home`, `draw`, & `away`
`handicap`	`market` - `book` - `outcome`	String	Handicap value of a book outcome. Used for `handicap` and `asian_handciap` markets ex. `-1` (home) and `1` (away) or `-1.5` (home) and `1.5` (away)
`id`	`market` - `book` - `outcome`	GUID	Unique ID of an outcome ex. `sr:outcome:1714`
`odds_american`	`market` - `book` - `outcome`	String	American odds value of a book outcome ex. `-161`
`open_odds_decimal`	`market` - `book` - `outcome`	String	Decimal odds value of a book outcome ex. `1.620`
`odds_fraction`	`market` - `book` - `outcome`	String	Fractional odds value of a book outcome ex. `8/13`
`open_odds_american`	`market` - `book` - `outcome`	String	Opening American odds value of a book outcome ex. `-161`
`open_odds_decimal`	`market` - `book` - `outcome`	String	Opening decimal odds value of a book outcome ex. `1.620`
`open_odds_fraction`	`market` - `book` - `outcome`	String	Opening fractional odds value of a book outcome ex. `8/13`
`open_total`	`market` - `book` - `outcome`	String	Opening total odds value of a book outcome ex. `24.5`
`open_handicap`	`market` - `book` - `outcome`	String	Opening handicap odds value of a book outcome ex. `-0.5`
`player_id`	`market` - `book` - `outcome`	String	Unique player ID for a book outcome. ex. `sr:player:2169312` This is used excusively for the Player Props* odds API*
`player_name`	`market` - `book` - `outcome`	String	Player name for a book outcome. ex. `Brown, Antario` This is used excusively for the Player Props* odds API*
`removed`	`market` - `book` - `outcome`	Boolean	Signifies an outcome has been removed when `true`
`spread`	`market` - `book` - `outcome`	Double	Spread line of a book outcome ex. `-1.5` (Baseball runs), `-17` (Football points)
`total`	`market` - `book` - `outcome`	Double	Total line of a book outcome ex. `8.5` (Baseball runs), `-65.5` (Football points)
`trend`	`market` - `book` - `outcome`	String	Odds trending value of a book outcome ex. `down`, `up`
`type`	`market` - `book` - `outcome`	String	Type of bet placements on a book outcome ex. `home` or `away`

Language

Credentials

Query

Click Try It! to start a request and see the response here!