MLB API – Sportradar IDs Added to Feeds

We've added an sr_id field to records in our MLB API, giving a Sportradar global ID alongside the existing UUID. Previously, MLB records carried a UUID only, with no crosswalk to Sportradar's global ID system — meaning entities present in both the MLB API and the Global Baseball or Odds APIs could not be reliably matched without a Mapping API lookup.

sr_id is now returned for games, teams, venues, players, and seasons across all MLB API versions, in both JSON and XML. The prefix varies by entity type:

Entity	`sr_id` format	Example
Game	`sr:match:<number>`	`sr:match:63301749`
Team	`sr:competitor:<number>`	`sr:competitor:3640`
Venue	`sr:venue:<number>`	`sr:venue:8049`
Player	`sr:player:<number>`	`sr:player:2412685`
Season	`sr:season:<number>`	`sr:season:134469`

The following feeds do not yet include sr_id, but will be updated in the coming weeks:

League Hierarchy
Daily Change Log
Free Agents

⭐ Benefit

Join MLB records to your other Sportradar integrations — Global Baseball, the Odds APIs, and anywhere else sr_id is used — by reading both the UUID and the sr_id directly from the MLB feed, without an extra call to the Mapping API.

📋 Recommended Actions

Read both the existing UUID and the new sr_id from MLB feed responses, and store them together so your records can be joined to other Sportradar products.
Continue to use the UUID as the primary identifier for MLB API records. sr_id is a supplementary crosswalk value for joining to other Sportradar products, not a replacement.
Use the correct prefix per entity type: sr:match: for games, sr:competitor: for teams, sr:venue: for venues, sr:player: for players, and sr:season: for seasons. There is no single shared prefix.
If your integration currently calls the Mapping API to join MLB entities to Global Baseball or Odds records, you can read the sr_id directly from the MLB feed instead.

🔢 Products

Sport	Product	Version(s)
Baseball	MLB API	v8, v7, v6.6, v6.5, v6

🔁 Endpoints Affected

All MLB API endpoints that return games, teams, venues, players, or seasons now include the sr_id field alongside the existing UUID.

☑️ Sample Request:

Seasons Endpoint

curl --request GET \
     --url https://api.sportradar.com/mlb/trial/v8/en/league/seasons.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

⚙️ Return Samples

<player xmlns="http://feed.elasticstats.com/schema/baseball/v8/profile.xsd" id="80de60c9-74e3-4a50-b128-b3dc7456a254" sr_id="sr:player:1373965" status="A" position="P" primary_position="DH" first_name="Shohei" last_name="Ohtani" preferred_name="Shohei" jersey_number="17" full_name="Shohei Ohtani" height="76" weight="210" throw_hand="R" bat_hand="L" high_school="Hanamaki Higashi (JPN)" birthdate="1994-07-05" birthcountry="JPN" birthcity="Oshu" pro_debut="2018-03-29" updated="2026-09-23T22:13:10+00:00" is_wbc_only="false" salary="28216944" rookie_year="2018" reference="660271">
    <team name="Dodgers" market="Los Angeles" abbr="LAD" id="ef64da7f-cfaf-4300-87b0-9313386b977c" sr_id="sr:competitor:3638"/>
    <seasons>
        <season id="d8c3c9ac-8002-4e1f-be49-8ad3958550d0" sr_id="sr:season:134469" year="2026" type="REG">
            <qualifiers>
                <hitting AL="false" MLB="true" NL="true"/>
                <pitching AL="false" MLB="false" NL="false"/>
            </qualifiers>
    ...

    "season": {
        "id": "d8c3c9ac-8002-4e1f-be49-8ad3958550d0",
        "sr_id": "sr:season:134469",
        "year": 2026,
        "type": "REG"
    },
    "games": [
        {
            "id": "fffbffca-9da3-4f35-870b-71075d9114bd",
            "sr_id": "sr:match:63302579",
            "status": "closed",
            "coverage": "full",
            "game_number": 1,
            "day_night": "N",
            "scheduled": "2026-07-31T01:40:00+00:00",
            "home_team": "d52d5339-cbdd-43f3-9dfa-a42fd588b9a3",
            "away_team": "a7723160-10b7-4277-a309-d8dd95a8ae65",
            "attendance": 42758,
            "duration": "2:53",
            "double_header": false,
            "entry_mode": "STOMP",
            "reference": "823271",
            "gameday_type": "P",
            "venue": {
                "name": "Petco Park",
                "market": "San Diego",
                "capacity": 40222,
                "surface": "grass",
                "address": "100 Park Boulevard",
                "city": "San Diego",
                "state": "CA",
                "zip": "92101",
                "country": "USA",
                "id": "0ab45d79-5475-4308-9f94-74b0c185ee6f",
                "sr_id": "sr:venue:8081",
                "field_orientation": "N",
                "stadium_type": "outdoor",
                "time_zone": "US/Pacific",
                "location": {
                    "lat": "32.70752890000001",
                    "lng": "-117.1568083"
                }
            },
            "home": {
                "name": "Padres",
                "market": "San Diego",
                "abbr": "SD",
                "id": "d52d5339-cbdd-43f3-9dfa-a42fd588b9a3",
                "sr_id": "sr:competitor:3636",
                "win": 55,
                "loss": 54
            },
            "away": {
                "name": "Giants",
                "market": "San Francisco",
                "abbr": "SF",
                "id": "a7723160-10b7-4277-a309-d8dd95a8ae65",
                "sr_id": "sr:competitor:3634",
                "win": 47,
                "loss": 62
            },
    ...