Player Mappings

get

https://api.sportradar.com/{sport}/{access_level}/v2/{language_code}/players/mappings.{format}

Global Baseball Player Mappings provides player id mapping between the Global Baseball API and the MLB API.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
TTL / Cache: 5 minutes
Data Updates: Occasional; merges only when duplicates are resolved
Recommended polling cadences for every feed are on the Update Frequencies chart of the Global Baseball Integration Guide.

📘
Resolving IDs Across Products
Learn how to use the Player Mappings feed to join Global Baseball player IDs to the MLB API's GUIDs in our ID Handling integration scenario.

Data Points

Mapping

Attribute	Parent Element	Type	Description
`external_id`	`mapping`	String	Unique League Specific ID of a player ex. `26f74b4f-77f4-4808-971d-1266d58ab292`
`id`	`mapping`	String	Unique General Sport ID of a player ex. `sr:player:1138912`

Path Params

sport

string

enum

required

Defaults to baseball

Sport type

baseball, softball

Allowed:

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

en (English), es (Spanish), ja (Japanese), ko (Korean), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

Allowed:

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Query Params

start

int32

The number of items to skip before starting to collect the result set.
Default: 0

Example: start=1000 to receive a 2nd page of results (if necessary)

Note: You may alternatively use offset

limit

int32

The number of items to return.
Maximum: 1000
Default value: 1000

Example: limit=200

Note: Pagination will often be required to pull all data within this feed. By default, the feed will return 1,000 player mappings.

Response

Update Frequency

Resolving IDs Across Products

Data Points

200200