Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Global Baseball Change Log

Find all updates to the Global Baseball v2 API and its documentation

Neutral Ground Signifier

Release DateEndpointsBenefit
08/19/2024All Summary Endpoints

All Sport Event Endpoints

Sport Event Timeline
We've added a neutral ground signifier to all games in the API.

All sport_event, summary, and timeline endpoints will now include a sport_event_conditions element with ground neutral="true" in cases of a neutral ground matchup.

This matches the current behavior of other General Sport APIs.
<sport_event id="sr:sport_event:46683279" start_time="2024-07-08T16:35:00+00:00" start_time_confirmed="true">
	<sport_event_context>
		<sport id="sr:sport:3" name="Baseball"/>
		<category id="sr:category:16" name="USA" country_code="USA"/>
		<competition id="sr:competition:109" name="MLB" gender="men"/>
		<season id="sr:season:112588" name="MLB 2024" start_date="2024-03-20" end_date="2024-11-03" year="2024" competition_id="sr:competition:109"/>
		<stage order="1" type="league" phase="regular season" start_date="2024-03-20" end_date="2024-10-01" year="2024"/>
		<round number="1"/>
		<groups>
			<group id="sr:league:80909" name="MLB 2024"/>
			<group id="sr:league:80919" name="MLB 2024, National League" group_name="National League"/>
			<group id="sr:league:80921" name="MLB 2024, National League Central" group_name="National League Central"/>
			<group id="sr:league:80923" name="MLB 2024, National League East" group_name="National League East"/>
		</groups>
	</sport_event_context>
	<coverage type="sport_event">
		<sport_event_properties basic_play_by_play="true" scores="live"/>
	</coverage>
	<competitors>
		<competitor id="sr:competitor:3637" name="Pittsburgh Pirates" country="USA" country_code="USA" abbreviation="PIT" qualifier="home" gender="male"/>
		<competitor id="sr:competitor:3629" name="New York Mets" country="USA" country_code="USA" abbreviation="NYM" qualifier="away" gender="male"/>
	</competitors>
	<venue id="sr:venue:8085" name="PNC Park" capacity="38753" city_name="Pittsburgh" country_name="USA" map_coordinates="40.4471507,-80.0064087" country_code="USA" timezone="America/New_York"/>
	<sport_event_conditions>
		<ground neutral="false"/>
	</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="8" away_score="2" winner_id="sr:competitor:3637">
	<period_scores>
		<period_score home_score="0" away_score="0" type="regular_period" number="1"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="2"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="3"/>
		<period_score home_score="2" away_score="0" type="regular_period" number="4"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="5"/>
		<period_score home_score="5" away_score="2" type="regular_period" number="6"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="7"/>
		<period_score home_score="1" away_score="0" type="regular_period" number="8"/>
		<period_score home_score="0" away_score="0" type="regular_period" number="9"/>
	</period_scores>
</sport_event_status>undefined</sport_event_summary>
{
  "generated_at": "2024-08-19T13:10:56+00:00",
  "sport_event": {
    "id": "sr:sport_event:46683279",
    "start_time": "2024-07-08T16:35:00+00:00",
    "start_time_confirmed": true,
    "sport_event_context": {
      "sport": {
        "id": "sr:sport:3",
        "name": "Baseball"
      },
      "category": {
        "id": "sr:category:16",
        "name": "USA",
        "country_code": "USA"
      },
      "competition": {
        "id": "sr:competition:109",
        "name": "MLB",
        "gender": "men"
      },
      "season": {
        "id": "sr:season:112588",
        "name": "MLB 2024",
        "start_date": "2024-03-20",
        "end_date": "2024-11-03",
        "year": "2024",
        "competition_id": "sr:competition:109"
      },
      "stage": {
        "order": 1,
        "type": "league",
        "phase": "regular season",
        "start_date": "2024-03-20",
        "end_date": "2024-10-01",
        "year": "2024"
      },
      "round": {
        "number": 1
      },
      "groups": [
        {
          "id": "sr:league:80909",
          "name": "MLB 2024"
        },
        {
          "id": "sr:league:80919",
          "name": "MLB 2024, National League",
          "group_name": "National League"
        },
        {
          "id": "sr:league:80921",
          "name": "MLB 2024, National League Central",
          "group_name": "National League Central"
        },
        {
          "id": "sr:league:80923",
          "name": "MLB 2024, National League East",
          "group_name": "National League East"
        }
      ]
    },
    "coverage": {
      "type": "sport_event",
      "sport_event_properties": {
        "basic_play_by_play": true,
        "scores": "live"
      }
    },
    "competitors": [
      {
        "id": "sr:competitor:3637",
        "name": "Pittsburgh Pirates",
        "country": "USA",
        "country_code": "USA",
        "abbreviation": "PIT",
        "qualifier": "home",
        "gender": "male"
      },
      {
        "id": "sr:competitor:3629",
        "name": "New York Mets",
        "country": "USA",
        "country_code": "USA",
        "abbreviation": "NYM",
        "qualifier": "away",
        "gender": "male"
      }
    ],
    "venue": {
      "id": "sr:venue:8085",
      "name": "PNC Park",
      "capacity": 38753,
      "city_name": "Pittsburgh",
      "country_name": "USA",
      "map_coordinates": "40.4471507,-80.0064087",
      "country_code": "USA",
      "timezone": "America/New_York"
    },
    "sport_event_conditions": {
      "ground": {
        "neutral": false
      }
    }
  },
  "sport_event_status": {
    "status": "closed",
    "match_status": "ended",
    "home_score": 8,
    "away_score": 2,
    "winner_id": "sr:competitor:3637",
    "period_scores": [
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 1
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 2
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 3
      },
      {
        "home_score": 2,
        "away_score": 0,
        "type": "regular_period",
        "number": 4
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 5
      },
      {
        "home_score": 5,
        "away_score": 2,
        "type": "regular_period",
        "number": 6
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 7
      },
      {
        "home_score": 1,
        "away_score": 0,
        "type": "regular_period",
        "number": 8
      },
      {
        "home_score": 0,
        "away_score": 0,
        "type": "regular_period",
        "number": 9
      }
    ]
  }
}


Venues for NPB, KBO, and CPBL

Release DateEndpointsBenefit
05/08/2024Competitor Profile

Summaries Endpoints

Timeline Endpoints
We have added venue information for the following leagues:

- Nippon Professional Baseball (NPB)
- Korea Baseball Organization (KBO)
- Chines Professional Baseball League (CPBL)
<sport_event id="sr:sport_event:47536313" start_time="2024-03-23T05:00:00+00:00" start_time_confirmed="true">
  <sport_event_context>
    <sport id="sr:sport:3" name="Baseball"/>
    <category id="sr:category:384" name="Republic of Korea" country_code="KOR"/>
    <competition id="sr:competition:2541" name="KBO League" gender="men"/>
    <season id="sr:season:115179" name="KBO League 2024" start_date="2024-03-23" end_date="2024-11-30" year="2024" competition_id="sr:competition:2541"/>
    <stage order="1" type="league" phase="regular season" start_date="2024-03-23" end_date="2024-08-29" year="2024"/>
    <round number="1"/>
    <groups>
      <group id="sr:league:81527" name="KBO 2024"/>
    </groups>
  </sport_event_context>
  <coverage type="sport_event">
    <sport_event_properties basic_play_by_play="false" scores="live"/>
  </coverage>
  <competitors>
    <competitor id="sr:competitor:249969" name="LG Twins" country="Republic of Korea" country_code="KOR" abbreviation="TWI" qualifier="home" gender="male"/>
    <competitor id="sr:competitor:249963" name="Hanwha Eagles" country="Republic of Korea" country_code="KOR" abbreviation="EAG" qualifier="away" gender="male"/>
  </competitors>
  <venue id="sr:venue:50439" name="Jamsil Baseball Stadium" capacity="25553" city_name="Seoul" country_name="Republic of Korea" map_coordinates="37.512389, 127.071972" country_code="KOR" timezone="Asia/Seoul"/>
</sport_event>
{
  "sport_event": {
    "id": "sr:sport_event:47536313",
    "start_time": "2024-03-23T05:00:00+00:00",
    "start_time_confirmed": true,
    "sport_event_context": {
      "sport": {
        "id": "sr:sport:3",
        "name": "Baseball"
      },
      "category": {
        "id": "sr:category:384",
        "name": "Republic of Korea",
        "country_code": "KOR"
      },
      "competition": {
        "id": "sr:competition:2541",
        "name": "KBO League",
        "gender": "men"
      },
      "season": {
        "id": "sr:season:115179",
        "name": "KBO League 2024",
        "start_date": "2024-03-23",
        "end_date": "2024-11-30",
        "year": "2024",
        "competition_id": "sr:competition:2541"
      },
      "stage": {
        "order": 1,
        "type": "league",
        "phase": "regular season",
        "start_date": "2024-03-23",
        "end_date": "2024-08-29",
        "year": "2024"
      },
      "round": {
        "number": 1
      },
      "groups": [
        {
          "id": "sr:league:81527",
          "name": "KBO 2024"
        }
      ]
    },
    "coverage": {
      "type": "sport_event",
      "sport_event_properties": {
        "basic_play_by_play": false,
        "scores": "live"
      }
    },
    "competitors": [
      {
        "id": "sr:competitor:249969",
        "name": "LG Twins",
        "country": "Republic of Korea",
        "country_code": "KOR",
        "abbreviation": "TWI",
        "qualifier": "home",
        "gender": "male"
      },
      {
        "id": "sr:competitor:249963",
        "name": "Hanwha Eagles",
        "country": "Republic of Korea",
        "country_code": "KOR",
        "abbreviation": "EAG",
        "qualifier": "away",
        "gender": "male"
      }
    ],
    "venue": {
      "id": "sr:venue:50439",
      "name": "Jamsil Baseball Stadium",
      "capacity": 25553,
      "city_name": "Seoul",
      "country_name": "Republic of Korea",
      "map_coordinates": "37.512389, 127.071972",
      "country_code": "KOR",
      "timezone": "Asia/Seoul"
    }
  },



Extra Innings Support

Release DateEndpointsBenefit
03/21/2024Summary & Timeline EndpointsWe updated the behavior of extra inning games for all Global Baseball events.

We now provide each extra inning as a unique entry, instead of one overtime entry with total home/away extra inning scores.
<sport_event_status status="closed" match_status="ended" home_score="8" away_score="7" 
 home_normaltime_score="7" away_normaltime_score="7" winner_id="sr:competitor:208513" 
 decided_inning="12">
  <period_scores>
    <period_score home_score="0" away_score="1" type="regular_period" number="1"/>
    <period_score home_score="0" away_score="0" type="regular_period" number="2"/>
    <period_score home_score="2" away_score="0" type="regular_period" number="3"/>
    <period_score home_score="2" away_score="0" type="regular_period" number="4"/>
    <period_score home_score="3" away_score="2" type="regular_period" number="5"/>
    <period_score home_score="0" away_score="0" type="regular_period" number="6"/>
    <period_score home_score="0" away_score="0" type="regular_period" number="7"/>
    <period_score home_score="0" away_score="0" type="regular_period" number="8"/>
    <period_score home_score="0" away_score="4" type="regular_period" number="9"/>
    <period_score home_score="0" away_score="0" type="overtime" number="10"/>
    <period_score home_score="0" away_score="0" type="overtime" number="11"/>
    <period_score home_score="1" away_score="0" type="overtime" number="12"/>
    <period_score home_score="1" away_score="0" type="overtime"/>
  </period_scores>
{
    "generated_at": "2024-03-21T17:00:38+00:00",
    "sport_event": {
        "id": "sr:sport_event:47495519",
        "start_time": "2024-02-28T00:00:00+00:00",
        "start_time_confirmed": true,
        "sport_event_context": {
            "sport": {
                "id": "sr:sport:3",
                "name": "Baseball"
            },
            "category": {
                "id": "sr:category:16",
                "name": "USA",
                "country_code": "USA"
            },
            "competition": {
                "id": "sr:competition:28416",
                "name": "NCAA, Regular Season",
                "parent_id": "sr:competition:37221",
                "gender": "men"
            },
            "season": {
                "id": "sr:season:115209",
                "name": "NCAA, Regular Season 2024",
                "start_date": "2024-02-16",
                "end_date": "2024-06-24",
                "year": "2024",
                "competition_id": "sr:competition:28416"
            },
            "stage": {
                "order": 1,
                "type": "league",
                "phase": "conference",
                "start_date": "2024-02-16",
                "end_date": "2024-06-24",
                "year": "2024"
            },
            "round": {
                "number": 1
            },
            "groups": [
                {
                    "id": "sr:league:81507",
                    "name": "NCAA 2024, Pacific-12 Conference",
                    "group_name": "Pac-12"
                }
            ]
        },
        "coverage": {
            "type": "sport_event",
            "sport_event_properties": {
                "basic_play_by_play": false,
                "scores": "post"
            }
        },
        "competitors": [
            {
                "id": "sr:competitor:208513",
                "name": "TCU Horned Frogs",
                "country": "USA",
                "country_code": "USA",
                "abbreviation": "TCU",
                "qualifier": "home",
                "gender": "male"
            },
            {
                "id": "sr:competitor:419945",
                "name": "Washington State Cougars",
                "country": "USA",
                "country_code": "USA",
                "abbreviation": "WAS",
                "qualifier": "away",
                "gender": "male"
            }
        ]
    },
    "sport_event_status": {
        "status": "closed",
        "match_status": "ended",
        "home_score": 8,
        "away_score": 7,
        "home_normaltime_score": 7,
        "away_normaltime_score": 7,
        "winner_id": "sr:competitor:208513",
        "period_scores": [
            {
                "home_score": 0,
                "away_score": 1,
                "type": "regular_period",
                "number": 1
            },
            {
                "home_score": 0,
                "away_score": 0,
                "type": "regular_period",
                "number": 2
            },
            {
                "home_score": 2,
                "away_score": 0,
                "type": "regular_period",
                "number": 3
            },
            {
                "home_score": 2,
                "away_score": 0,
                "type": "regular_period",
                "number": 4
            },
            {
                "home_score": 3,
                "away_score": 2,
                "type": "regular_period",
                "number": 5
            },
            {
                "home_score": 0,
                "away_score": 0,
                "type": "regular_period",
                "number": 6
            },
            {
                "home_score": 0,
                "away_score": 0,
                "type": "regular_period",
                "number": 7
            },
            {
                "home_score": 0,
                "away_score": 0,
                "type": "regular_period",
                "number": 8
            },
            {
                "home_score": 0,
                "away_score": 4,
                "type": "regular_period",
                "number": 9
            },
            {
                "home_score": 0,
                "away_score": 0,
                "type": "overtime",
                "number": 10
            },
            {
                "home_score": 0,
                "away_score": 0,
                "type": "overtime",
                "number": 11
            },
            {
                "home_score": 1,
                "away_score": 0,
                "type": "overtime",
                "number": 12
            },
            {
                "home_score": 1,
                "away_score": 0,
                "type": "overtime"
            }
        ],
        "decided_inning": 12
    }
}

Update applies to: Global Baseball v2



Coverage Node Update

Release DateEndpointsBenefit
02/26/2024Competitor Summaries

Competitor vs Competitor

Daily Summaries

Live Summaries

Player Summaries

Season Info

Season Probabilities

Season Summaries

Sport Event Summary

Sport Event Timeline

Live Probabilities

Sport Event Probabilities

Timeline Probabilities
Made the following updates to coverage level properties.

For endpoints containing Sport Events info:

Removed the live attribute from the current coverage node and added type="sport_event"

Inserted a sport_event_properties node into coverage with the following attributes:

- basic_play_by_play

- scores (live or post)For the Season Info endpoint:Inserted a new coverage node within the season_info node between season and stages which contains type="competition"Inserted a competition_properties node within coverage with the following attributes:

- brackets

- schedules

- standings (live, post, false)

- team_squadsInserted a sport_event_properties node within coverage with the following attributes:

- basic_play_by_play

- scores (live or post)
<sport_event_summary
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://schemas.sportradar.com/sportsapi/baseball/v2" generated_at="2024-01-16T13:50:20+00:00">
  <sport_event id="sr:sport_event:46682103" start_time="2024-03-20T10:05:00+00:00" start_time_confirmed="true">
    <sport_event_context>
      <sport id="sr:sport:3" name="Baseball"/>
      <category id="sr:category:16" name="USA" country_code="USA"/>
      <competition id="sr:competition:109" name="MLB" gender="men"/>
      <season id="sr:season:112588" name="MLB 2024" start_date="2024-03-20" end_date="2024-11-03" year="2024" competition_id="sr:competition:109"/>
      <stage order="1" type="league" phase="regular season" start_date="2024-03-20" end_date="2024-10-01" year="2024"/>
      <round number="1"/>
      <groups>
        <group id="sr:league:80909" name="MLB 2024"/>
        <group id="sr:league:80919" name="MLB 2024, National League" group_name="National League"/>
        <group id="sr:league:80925" name="MLB 2024, National League West" group_name="National League West"/>
      </groups>
    </sport_event_context>
    <coverage type="sport_event">
      <sport_event_properties basic_play_by_play="true" scores="live"/>
    </coverage>
    <competitors>
      <competitor id="sr:competitor:3636" name="San Diego Padres" country="USA" country_code="USA" abbreviation="SD" qualifier="home" gender="male"/>
      <competitor id="sr:competitor:3638" name="Los Angeles Dodgers" country="USA" country_code="USA" abbreviation="LAD" qualifier="away" gender="male"/>
    </competitors>
    <venue id="sr:venue:50445" name="Gocheok Sky Dome" capacity="16813" city_name="Seoul" country_name="Republic of Korea" map_coordinates="37.498222, 126.86725" country_code="KOR" timezone="Asia/Seoul"/>
  </sport_event>
  <sport_event_status status="not_started" match_status="not_started"/>
</sport_event_summary>
<season_info
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://schemas.sportradar.com/sportsapi/baseball/v2" generated_at="2024-01-16T14:11:09+00:00">
  <season id="sr:season:112588" name="MLB 2024" start_date="2024-03-20" end_date="2024-11-03" year="2024" competition_id="sr:competition:109">
    <sport id="sr:sport:3" name="Baseball"/>
    <category id="sr:category:16" name="USA" country_code="USA"/>
    <competition id="sr:competition:109" name="MLB" gender="men"/>
  </season>
  <coverage type="competition">
    <competition_properties brackets="false" schedules="true" standings="post" team_squads="true"/>
    <sport_event_properties basic_play_by_play="true" scores="post"/>
  </coverage>
  <stages>
    <stage order="1" type="league" phase="regular season" start_date="2024-03-20" end_date="2024-10-01" year="2024">
      <groups>
        <group id="sr:league:80909" name="MLB 2024" max_rounds="162">
          <competitors>
            <competitor id="sr:competitor:3644" name="Chicago White Sox" country="USA" country_code="USA" abbreviation="CWS" gender="male"/>
            <competitor id="sr:competitor:3627" name="Chicago Cubs" country="USA" country_code="USA" abbreviation="CHC" gender="male"/>
            <competitor id="sr:competitor:3633" name="Cincinnati Reds" country="USA" country_code="USA" abbreviation="CIN" gender="male"/>
            <competitor id="sr:competitor:3650" name="Cleveland Guardians" country="USA" country_code="USA" abbreviation="CLE" gender="male"/>
            <competitor id="sr:competitor:3654" name="New York Yankees" country="USA" country_code="USA" abbreviation="NYY" gender="male"/>
            <competitor id="sr:competitor:3651" name="Kansas City Royals" country="USA" country_code="USA" abbreviation="KC" gender="male"/>
            <competitor id="sr:competitor:3652" name="Baltimore Orioles" country="USA" country_code="USA" abbreviation="BAL" gender="male"/>
            <competitor id="sr:competitor:3646" name="Boston Red Sox" country="USA" country_code="USA" abbreviation="BOS" gender="male"/>
            <competitor id="sr:competitor:3628" name="Colorado Rockies" country="USA" country_code="USA" abbreviation="COL" gender="male"/>
            <competitor id="sr:competitor:3632" name="St. Louis Cardinals" country="USA" country_code="USA" abbreviation="STL" gender="male"/>
            <competitor id="sr:competitor:3634" name="San Francisco Giants" country="USA" country_code="USA" abbreviation="SF" gender="male"/>
            <competitor id="sr:competitor:3636" name="San Diego Padres" country="USA" country_code="USA" abbreviation="SD" gender="male"/>
            <competitor id="sr:competitor:3639" name="Miami Marlins" country="USA" country_code="USA" abbreviation="MIA" gender="male"/>
            <competitor id="sr:competitor:3635" name="Philadelphia Phillies" country="USA" country_code="USA" abbreviation="PHI" gender="male"/>
            <competitor id="sr:competitor:3638" name="Los Angeles Dodgers" country="USA" country_code="USA" abbreviation="LAD" gender="male"/>
            <competitor id="sr:competitor:3630" name="Milwaukee Brewers" country="USA" country_code="USA" abbreviation="MIL" gender="male"/>
            <competitor id="sr:competitor:3641" name="Seattle Mariners" country="USA" country_code="USA" abbreviation="SEA" gender="male"/>
            <competitor id="sr:competitor:3645" name="Oakland Athletics" country="USA" country_code="USA" abbreviation="OAK" gender="male"/>
            <competitor id="sr:competitor:3629" name="New York Mets" country="USA" country_code="USA" abbreviation="NYM" gender="male"/>
            <competitor id="sr:competitor:3655" name="Houston Astros" country="USA" country_code="USA" abbreviation="HOU" gender="male"/>
            <competitor id="sr:competitor:3637" name="Pittsburgh Pirates" country="USA" country_code="USA" abbreviation="PIT" gender="male"/>
            <competitor id="sr:competitor:3640" name="Arizona Diamondbacks" country="USA" country_code="USA" abbreviation="AZ" gender="male"/>
            <competitor id="sr:competitor:3648" name="Detroit Tigers" country="USA" country_code="USA" abbreviation="DET" gender="male"/>
            <competitor id="sr:competitor:3649" name="Minnesota Twins" country="USA" country_code="USA" abbreviation="MIN" gender="male"/>
            <competitor id="sr:competitor:3647" name="Texas Rangers" country="USA" country_code="USA" abbreviation="TEX" gender="male"/>
            <competitor id="sr:competitor:3653" name="Tampa Bay Rays" country="USA" country_code="USA" abbreviation="TB" gender="male"/>
            <competitor id="sr:competitor:3642" name="Toronto Blue Jays" country="USA" country_code="USA" abbreviation="TOR" gender="male"/>
            <competitor id="sr:competitor:3656" name="Atlanta Braves" country="USA" country_code="USA" abbreviation="ATL" gender="male"/>
            <competitor id="sr:competitor:5930" name="Washington Nationals" country="USA" country_code="USA" abbreviation="WSH" gender="male"/>
            <competitor id="sr:competitor:5929" name="Los Angeles Angels" country="USA" country_code="USA" abbreviation="LAA" gender="male"/>
          </competitors>
        </group>
      </groups>
    </stage>
    <stage order="1" type="league" phase="conference" start_date="2024-03-20" end_date="2024-10-01" year="2024">
      <groups>
        <group id="sr:league:80911" name="MLB 2024, American League" max_rounds="162" group_name="American League" parent_group_id="sr:league:80909">
          <competitors>
            <competitor id="sr:competitor:3644" name="Chicago White Sox" country="USA" country_code="USA" abbreviation="CWS" gender="male"/>
            <competitor id="sr:competitor:3650" name="Cleveland Guardians" country="USA" country_code="USA" abbreviation="CLE" gender="male"/>
            <competitor id="sr:competitor:3654" name="New York Yankees" country="USA" country_code="USA" abbreviation="NYY" gender="male"/>
            <competitor id="sr:competitor:3651" name="Kansas City Royals" country="USA" country_code="USA" abbreviation="KC" gender="male"/>
            <competitor id="sr:competitor:3652" name="Baltimore Orioles" country="USA" country_code="USA" abbreviation="BAL" gender="male"/>
            <competitor id="sr:competitor:3646" name="Boston Red Sox" country="USA" country_code="USA" abbreviation="BOS" gender="male"/>
            <competitor id="sr:competitor:3641" name="Seattle Mariners" country="USA" country_code="USA" abbreviation="SEA" gender="male"/>
            <competitor id="sr:competitor:3645" name="Oakland Athletics" country="USA" country_code="USA" abbreviation="OAK" gender="male"/>
            <competitor id="sr:competitor:3655" name="Houston Astros" country="USA" country_code="USA" abbreviation="HOU" gender="male"/>
            <competitor id="sr:competitor:3648" name="Detroit Tigers" country="USA" country_code="USA" abbreviation="DET" gender="male"/>
            <competitor id="sr:competitor:3649" name="Minnesota Twins" country="USA" country_code="USA" abbreviation="MIN" gender="male"/>
            <competitor id="sr:competitor:3647" name="Texas Rangers" country="USA" country_code="USA" abbreviation="TEX" gender="male"/>
            <competitor id="sr:competitor:3653" name="Tampa Bay Rays" country="USA" country_code="USA" abbreviation="TB" gender="male"/>
            <competitor id="sr:competitor:3642" name="Toronto Blue Jays" country="USA" country_code="USA" abbreviation="TOR" gender="male"/>
            <competitor id="sr:competitor:5929" name="Los Angeles Angels" country="USA" country_code="USA" abbreviation="LAA" gender="male"/>
          </competitors>
        </group>
        <group id="sr:league:80919" name="MLB 2024, National League" max_rounds="162" group_name="National League" parent_group_id="sr:league:80909">
          <competitors>
            <competitor id="sr:competitor:3627" name="Chicago Cubs" country="USA" country_code="USA" abbreviation="CHC" gender="male"/>
            <competitor id="sr:competitor:3633" name="Cincinnati Reds" country="USA" country_code="USA" abbreviation="CIN" gender="male"/>
            <competitor id="sr:competitor:3628" name="Colorado Rockies" country="USA" country_code="USA" abbreviation="COL" gender="male"/>
            <competitor id="sr:competitor:3632" name="St. Louis Cardinals" country="USA" country_code="USA" abbreviation="STL" gender="male"/>
            <competitor id="sr:competitor:3634" name="San Francisco Giants" country="USA" country_code="USA" abbreviation="SF" gender="male"/>
            <competitor id="sr:competitor:3636" name="San Diego Padres" country="USA" country_code="USA" abbreviation="SD" gender="male"/>
            <competitor id="sr:competitor:3639" name="Miami Marlins" country="USA" country_code="USA" abbreviation="MIA" gender="male"/>
            <competitor id="sr:competitor:3635" name="Philadelphia Phillies" country="USA" country_code="USA" abbreviation="PHI" gender="male"/>
            <competitor id="sr:competitor:3638" name="Los Angeles Dodgers" country="USA" country_code="USA" abbreviation="LAD" gender="male"/>
            <competitor id="sr:competitor:3630" name="Milwaukee Brewers" country="USA" country_code="USA" abbreviation="MIL" gender="male"/>
            <competitor id="sr:competitor:3629" name="New York Mets" country="USA" country_code="USA" abbreviation="NYM" gender="male"/>
            <competitor id="sr:competitor:3637" name="Pittsburgh Pirates" country="USA" country_code="USA" abbreviation="PIT" gender="male"/>
            <competitor id="sr:competitor:3640" name="Arizona Diamondbacks" country="USA" country_code="USA" abbreviation="AZ" gender="male"/>
            <competitor id="sr:competitor:3656" name="Atlanta Braves" country="USA" country_code="USA" abbreviation="ATL" gender="male"/>
            <competitor id="sr:competitor:5930" name="Washington Nationals" country="USA" country_code="USA" abbreviation="WSH" gender="male"/>
          </competitors>
        </group>
      </groups>
    </stage>
    <stage order="1" type="league" phase="division" start_date="2024-03-20" end_date="2024-10-01" year="2024">
      <groups>
        <group id="sr:league:80913" name="MLB 2024, American League Central" max_rounds="162" group_name="American League Central">
          <competitors>
            <competitor id="sr:competitor:3644" name="Chicago White Sox" country="USA" country_code="USA" abbreviation="CWS" gender="male"/>
            <competitor id="sr:competitor:3650" name="Cleveland Guardians" country="USA" country_code="USA" abbreviation="CLE" gender="male"/>
            <competitor id="sr:competitor:3651" name="Kansas City Royals" country="USA" country_code="USA" abbreviation="KC" gender="male"/>
            <competitor id="sr:competitor:3648" name="Detroit Tigers" country="USA" country_code="USA" abbreviation="DET" gender="male"/>
            <competitor id="sr:competitor:3649" name="Minnesota Twins" country="USA" country_code="USA" abbreviation="MIN" gender="male"/>
          </competitors>
        </group>
        <group id="sr:league:80915" name="MLB 2024, American League East" max_rounds="162" group_name="American League East">
          <competitors>
            <competitor id="sr:competitor:3654" name="New York Yankees" country="USA" country_code="USA" abbreviation="NYY" gender="male"/>
            <competitor id="sr:competitor:3652" name="Baltimore Orioles" country="USA" country_code="USA" abbreviation="BAL" gender="male"/>
            <competitor id="sr:competitor:3646" name="Boston Red Sox" country="USA" country_code="USA" abbreviation="BOS" gender="male"/>
            <competitor id="sr:competitor:3653" name="Tampa Bay Rays" country="USA" country_code="USA" abbreviation="TB" gender="male"/>
            <competitor id="sr:competitor:3642" name="Toronto Blue Jays" country="USA" country_code="USA" abbreviation="TOR" gender="male"/>
          </competitors>
        </group>
        <group id="sr:league:80917" name="MLB 2024, American League West" max_rounds="162" group_name="American League West">
          <competitors>
            <competitor id="sr:competitor:3641" name="Seattle Mariners" country="USA" country_code="USA" abbreviation="SEA" gender="male"/>
            <competitor id="sr:competitor:3645" name="Oakland Athletics" country="USA" country_code="USA" abbreviation="OAK" gender="male"/>
            <competitor id="sr:competitor:3655" name="Houston Astros" country="USA" country_code="USA" abbreviation="HOU" gender="male"/>
            <competitor id="sr:competitor:3647" name="Texas Rangers" country="USA" country_code="USA" abbreviation="TEX" gender="male"/>
            <competitor id="sr:competitor:5929" name="Los Angeles Angels" country="USA" country_code="USA" abbreviation="LAA" gender="male"/>
          </competitors>
        </group>
        <group id="sr:league:80921" name="MLB 2024, National League Central" max_rounds="162" group_name="National League Central">
          <competitors>
            <competitor id="sr:competitor:3627" name="Chicago Cubs" country="USA" country_code="USA" abbreviation="CHC" gender="male"/>
            <competitor id="sr:competitor:3633" name="Cincinnati Reds" country="USA" country_code="USA" abbreviation="CIN" gender="male"/>
            <competitor id="sr:competitor:3632" name="St. Louis Cardinals" country="USA" country_code="USA" abbreviation="STL" gender="male"/>
            <competitor id="sr:competitor:3630" name="Milwaukee Brewers" country="USA" country_code="USA" abbreviation="MIL" gender="male"/>
            <competitor id="sr:competitor:3637" name="Pittsburgh Pirates" country="USA" country_code="USA" abbreviation="PIT" gender="male"/>
          </competitors>
        </group>
        <group id="sr:league:80923" name="MLB 2024, National League East" max_rounds="162" group_name="National League East">
          <competitors>
            <competitor id="sr:competitor:3639" name="Miami Marlins" country="USA" country_code="USA" abbreviation="MIA" gender="male"/>
            <competitor id="sr:competitor:3635" name="Philadelphia Phillies" country="USA" country_code="USA" abbreviation="PHI" gender="male"/>
            <competitor id="sr:competitor:3629" name="New York Mets" country="USA" country_code="USA" abbreviation="NYM" gender="male"/>
            <competitor id="sr:competitor:3656" name="Atlanta Braves" country="USA" country_code="USA" abbreviation="ATL" gender="male"/>
            <competitor id="sr:competitor:5930" name="Washington Nationals" country="USA" country_code="USA" abbreviation="WSH" gender="male"/>
          </competitors>
        </group>
        <group id="sr:league:80925" name="MLB 2024, National League West" max_rounds="162" group_name="National League West">
          <competitors>
            <competitor id="sr:competitor:3628" name="Colorado Rockies" country="USA" country_code="USA" abbreviation="COL" gender="male"/>
            <competitor id="sr:competitor:3634" name="San Francisco Giants" country="USA" country_code="USA" abbreviation="SF" gender="male"/>
            <competitor id="sr:competitor:3636" name="San Diego Padres" country="USA" country_code="USA" abbreviation="SD" gender="male"/>
            <competitor id="sr:competitor:3638" name="Los Angeles Dodgers" country="USA" country_code="USA" abbreviation="LAD" gender="male"/>
            <competitor id="sr:competitor:3640" name="Arizona Diamondbacks" country="USA" country_code="USA" abbreviation="AZ" gender="male"/>
          </competitors>
        </group>
      </groups>
    </stage>
  </stages>
</season_info>


NCAA Women's Softball

Release DateEndpointsBenefit
02/16/2024AllWe have added coverage for NCAA Women's Softball for the 2024 season!

All softball competitions can be accessed by changing the sport parameter from baseball to softball.

Please note that you must use your Master API Key within your account to access softball data.
<competitions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2024-02-16T15:40:02+00:00" xmlns="http://schemas.sportradar.com/sportsapi/softball/v2" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/softball/v2 https://schemas.sportradar.com/sportsapi/softball/v2/schemas/competitions.xsd">
    <competition id="sr:competition:42259" name="NCAA Regular Season, Women" gender="women">
        <category id="sr:category:562" name="USA" country_code="USA"/>
    </competition>
</competitions>
{
    "generated_at": "2024-02-16T15:56:12+00:00",
    "competitions": [
        {
            "id": "sr:competition:42259",
            "name": "NCAA Regular Season, Women",
            "gender": "women",
            "category": {
                "id": "sr:category:562",
                "name": "USA",
                "country_code": "USA"
            }
        }
    ]
}

Update applies to: Global Baseball v2



Active Season Indicator

Release DateFeeds AffectedBenefit
08/28/2023Sport Events CreatedAdded a active_season attribute for newly created matches appearing in the Sport Events Created endpoint.

When marked as true this will signify that an added match is part of an active season.
    <sport_event_created id="sr:sport_event:43393169" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
    <sport_event_created id="sr:sport_event:43393167" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
    <sport_event_created id="sr:sport_event:43393165" active_season="true" created_at="2023-08-30T14:42:38+00:00"/>
    <sport_event_created id="sr:sport_event:43393163" active_season="true" created_at="2023-08-30T14:42:37+00:00"/>
    <sport_event_created id="sr:sport_event:43393029" active_season="true" created_at="2023-08-30T14:37:40+00:00"/>
{
    "generated_at": "2023-08-30T14:47:30+00:00",
    "sport_events_created": [
        {
            "id": "sr:sport_event:43393169",
            "active_season": true,
            "created_at": "2023-08-30T14:42:39+00:00"
        },
        {
            "id": "sr:sport_event:43393167",
            "active_season": true,
            "created_at": "2023-08-30T14:42:39+00:00"
        },
        {
            "id": "sr:sport_event:43393165",
            "active_season": true,
            "created_at": "2023-08-30T14:42:38+00:00"
        },
        {
            "id": "sr:sport_event:43393163",
            "active_season": true,
            "created_at": "2023-08-30T14:42:37+00:00"
        },


New Cup Round Data

Release DateFeeds AffectedBenefit
03/20/2023Season LinksAdded order, state, and winner_id to cup rounds in the Season Links endpoint.

These new fields can be leveraged to determine the status, order, and winner of a cup round within a season/tournament.


Age Group & Gender Additions

Release DateFeeds AffectedBenefit
03/13/2023Competitor Profile
Competitor Summaries
Competitor vs Competitor
Daily Summaries
Live Summaries
Player Profile
Season Info
Season Lineups
Season Probabilities
Season Standings
Season Summaries
Seasonal Competitor Statistics
Sport Event Lineups
Sport Event Summary
Sport Event Timeline
Push Statistics
Added age_group and gender to competitor elements in several endpoints.

This update follows the existing format of the Soccer API, and will help to efficiently distinguish these competitor (team) characteristics.


Pagination Update to Season Probabilities

Release DateFeeds AffectedBenefit
03/03/2023Season ProbabilitiesAdded pagination to the Season Probabilities endpoint for several APIs.

Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required. For example, to load the next 200 events you will need to append &start=200 to the call and to load the next 200 add &start=400 and so on.


Category Data

Release DateFeeds AffectedBenefit
01/20/2023Competition InfoAdded the category element to the Competition Info endpoint. This includes category id, name, and country_code. The category will be represented by the country or International to better distinguish the country designation.


'Competitor Merge Mappings' Endpoint

Release DateFeeds AffectedBenefit
08/23/2022Competitor Merge Mappings
Player Merge Mappings
Added the Competitor Merge Mappings endpoint to a variety of APIs. This feed provides the valid Sportradar Id in cases when two competitors have been merged into one. This feed was previously present in the Soccer API.

Also added a Player Merge Mappings endpoint to the Aussie Rules Football API.


'Sport Events Created' Endpoint

Release DateFeeds AffectedBenefit
06/29/2022Sport Events CreatedOur new Sport Events Created endpoint provides a list of all events created within the last 24 hours. Send requests to this endpoint as needed to assist in locating and storing newly created events.


Gender Distinction

Release DateFeeds AffectedBenefit
12/09/2021Competition Info
Competitions
Competitor Summaries
Competitor vs Competitor
Daily Summaries
Live Summaries
Player Summaries
Season Info
Season Probabilities
Season Summaries
Sport Event Summary
Sport Event Timeline
Live Probabilities
Sport Event Probabilities
Timeline Probabilities
Added competition gender to several endpoints.


Category Info Addition

Release DateFeeds AffectedBenefit
11/04/2021Competition Info
Competitions
Competitor Summaries
Competitor vs Competitor
Daily Summaries
Live Summaries
Player Summaries
Season Info
Season Probabilities
Season Summaries
Sport Event Summary
Sport Event Timeline
Live Probabilities
Sport Event Probabilities
Timeline Probabilities
Added category id, category name, and category country_code to the Competitions feed.


Pagination Addition

Release DateFeeds AffectedBenefit
10/15/2021Daily Summaries
Season Summaries
Sport Events Updated
Added a pagination support description for the following feeds: Daily Summaries, Season Summaries, Sport Events Updated.


Seasonal Stat Endpoints

Release DateFeeds AffectedBenefit
09/10/2021Season Competitors
Season Links
Season Players
Added data points to support the addition of three seasonal statistic feeds.


Probabilities Package

Release DateFeeds AffectedBenefit
03/10/2021Live Probabilities
Season Outright Probabilities
Sport Event Probabilities
Sport Event Upcoming Probabilities
Timeline Probabilities
Added data points to support the addition of the probabilities package feeds.


Mappings Endpoints

Release DateFeeds AffectedBenefit
02/19/2021Competitor Mappings
Player Mappings
Player Merge Mappings
Season Mappings
Sport Event Mappings
Added data points to support the addition of the mapping feeds.


Season Data

Release DateFeeds AffectedBenefit
05/13/2020Season InfoAdded the following data points: competition_status, venue_reduced_capacity, and venue_reduced_capacity_max.


Venue Data

Release DateFeeds AffectedBenefit
05/13/2020Competitor Summaries
Competitor vs Competitor
Daily Summaries
Live Summaries
Player Summaries
Season Probabilities
Season Summaries
Sport Event Summary
Sport Event Timeline
Added the following venue data points: changed, reduced_capacity, and reduced_capacity_max.


Added 'decided_inning' Attribute

Release DateFeeds AffectedBenefit
06/04/2019Competitor Summaries
Competitor vs Competitor
Daily Summaries
Live Summaries
Live Timelines
Live Timelines Delta
Player Summariess
Season Summaries
Sport Event Summary
Sport Event Timeline
Added data point: decided_inning.


API Release

Release DateFeeds AffectedBenefit
05/13/2019AllInitial release of Global Baseball v2