Find all updates to the Global Baseball v2 API and its documentation
Improved Inning and Play Start and End Timeline Behavior
🗓️ Release Date 06/11/2026
We've enhanced the behavior of inning start and inning end events in the Timeline endpoints of our Global Baseball API.
⭐ Benefit
These updates provide clearer inning and play boundaries within timeline responses, making it easier to build accurate play-by-play experiences, identify half-inning transitions, and group related events into complete play sequences.
Change 1: Removed inning_score_update Event
The event.type value of inning_score_update has been removed going forward, as it did not add meaningful value to the timeline story.
This event type was undocumented but could appear in timeline responses.
<event id="2329970266" type="inning_score_update" time="2026-04-16T11:05:23+00:00"
inning="6" inning_home_score="0" inning_away_score="0"/>Change 2: Added inning_half_end Event
We've added a new inning_half_end event type that is generated when a half-inning concludes.
Previously, timelines contained two consecutive inning_half_start events during the transition between half-innings, making it difficult to determine exactly when a half-inning ended.
Going forward, an inning_half_end event will be generated when the half-inning concludes, followed by an inning_half_start event when the next half-inning begins.
Previous Behavior:
<event id="2329970334" type="inning_half_start" time="2026-04-16T11:05:26+00:00"/>
<!-- ~3 minute break between half-innings -->
<event id="2329972868" type="inning_half_start" time="2026-04-16T11:08:44+00:00" inning_half="top"/>New Behavior:
<event id="2329970334" type="inning_half_end" time="2026-04-16T11:05:26+00:00"/>
<!-- ~3 minute break between half-innings -->
<event id="2329972868" type="inning_half_start" time="2026-04-16T11:08:44+00:00" inning_half="top"/>Change 3: play_start and play_end Events
We've added play_start and play_end event types to the Timeline endpoints to clearly identify the beginning and end of each play sequence.
Previously, consumers had to infer play boundaries from the events that occurred during a play. This could be particularly challenging for multi-run scoring plays or other sequences containing multiple timeline events.
Going forward, each play will be wrapped by play_start and play_end events, making it easier to group related events together and accurately reconstruct play-by-play action.
Previous Behavior:
<event id="2182791814" type="ball_in_play" time="2025-11-02T01:00:29+00:00" inning_half="bottom">
<players>
<player id="sr:player:1100835" name="Bichette, Bo" type="batter"/>
</players>
</event>
<event id="2182791914" type="run_scored" time="2025-11-02T01:00:37+00:00" inning_half="bottom" scored_run_type="earned_run" starting_base="1" count_balls="0" count_strikes="0" outs="1">
<players>
<player id="sr:player:1100805" name="Guerrero Jr., Vladimir" type="runner"/>
<player id="sr:player:1100835" name="Bichette, Bo" type="batter"/>
</players>
</event>
<event id="2182791918" type="run_scored" time="2025-11-02T01:00:37+00:00" inning_half="bottom" scored_run_type="earned_run" starting_base="3" count_balls="0" count_strikes="0" outs="1">
<players>
<player id="sr:player:843127" name="Springer, George" type="runner"/>
<player id="sr:player:1100835" name="Bichette, Bo" type="batter"/>
</players>
</event>
<event id="2182791920" type="run_scored" time="2025-11-02T01:00:37+00:00" inning_half="bottom" scored_run_type="home_run" count_balls="0" count_strikes="0" outs="1">
<players>
<player id="sr:player:1100835" name="Bichette, Bo" type="runner"/>
<player id="sr:player:1100835" name="Bichette, Bo" type="batter"/>
</players>
</event>New Behavior:
<event id="2382615700" type="play_start" time="2026-06-09T09:33:22+00:00" inning_half="top">
<players>
<player id="sr:player:3147924" name="Gyun-an, Na" type="pitcher"/>
<player id="sr:player:1086530" name="Cameron, Daz" type="batter"/>
</players>
</event>
<event id="2382615790" type="ball_in_play" time="2026-06-09T09:33:30+00:00" inning_half="top">
<players>
<player id="sr:player:3147924" name="Gyun-an, Na" type="pitcher"/>
</players>
</event>
<event id="2382615890" type="run_scored" time="2026-06-09T09:33:40+00:00" inning_half="top" scored_run_type="earned_run" starting_base="1" count_balls="2" count_strikes="0" outs="0">
<players>
<player id="sr:player:3148612" name="Soo-bin, Jung" type="runner"/>
<player id="sr:player:1086530" name="Cameron, Daz" type="batter"/>
</players>
</event>
<event id="2382615920" type="run_scored" time="2026-06-09T09:33:43+00:00" inning_half="top" scored_run_type="home_run" count_balls="0" count_strikes="0" outs="0">
<players>
<player id="sr:player:1086530" name="Cameron, Daz" type="runner"/>
<player id="sr:player:1086530" name="Cameron, Daz" type="batter"/>
</players>
</event>
<event id="2382615976" type="play_end" time="2026-06-09T09:33:48+00:00"/>⚠️ Integration Impact
- The undocumented
inning_score_updateevent type will no longer appear in timeline responses. - Consumers currently handling
inning_score_updateshould remove any related processing logic. - Consumers using consecutive
inning_half_startevents to infer the end of a half-inning should transition to using the newinning_half_endevent type. - New
play_startandplay_endevent types will now appear in timeline responses. - Consumers that process timeline events using event type filtering, validation rules, or enumerated event lists should update their integrations to recognize the new event types.
📋 Recommended Actions
- Review any timeline-processing logic that references
inning_score_update. - Update inning transition workflows to recognize the new
inning_half_endevent type. - If you currently infer the end of a half-inning from consecutive
inning_half_startevents, update your integration to useinning_half_enddirectly. - Update any event-type mappings, allowlists, or validation logic to support the new
play_startandplay_endevent types. - Consider using
play_startandplay_endto group related timeline events into complete play sequences. - Test timeline parsing against the updated event sequence before deployment.
☑️ Sample Request:
Sport Event Timeline
curl --request GET \
--url https://api.sportradar.com/baseball/trial/v2/en/sport_events/{sport_event_id}/timeline.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
City IDs in Venue Objects
🗓️ Release Date 06/01/2026
We've added a city_id unique identifier to all venue objects across our General Sport Media APIs. The new field is included alongside the existing city_name field and is available in all feeds that contain venue information.
This is a non-breaking enhancement to existing responses.
"city_name": "Liverpool",
"city_id": "sr:city:31",⭐ Benefit
Use a city's unique identifier for entity linking, data enrichment, and cross-feed correlation wherever venue information is available.
☑️ Sample Requests:
Soccer - Competitor Profile
curl --request GET \
--url https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/profile.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'⚙️ Return Samples
<venue id="sr:venue:8117" name="Dodger Stadium" capacity="56000" city_name="Los Angeles, CA" city_id="sr:city:963" country_name="USA" map_coordinates="34.0745409, -118.2408881" country_code="USA" timezone="America/Los_Angeles"/>"venue": {
"id": "sr:venue:8117",
"name": "Dodger Stadium",
"capacity": 56000,
"city_name": "Los Angeles, CA",
"city_id": "sr:city:963",
"country_name": "USA",
"map_coordinates": "34.0745409, -118.2408881",
"country_code": "USA",
"timezone": "America/Los_Angeles"
},Game Statistics & Timeline Improvements
| Release Date | Endpoints | Benefit |
|---|---|---|
| 03/05/2026 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Summaries Sport Event Summary Sport Event Timeline | We’ve added game statistics and improved our Timeline data and structure for our Global Baseball API. Game Stats At Bats, Earned Runs, Errors, Hits, Hits Allowed, Home Runs, Innings Pitched, Runs, RBIs, Saves, Stolen Bases, Strikeouts, Walks, Walks Allowed The Timeline Updates The update focuses on bringing the Global Baseball API into alignment with Sportradar’s other "Global" sports products. See our Timeline Updates page for more detailed info. |
<timeline>
<event id="2182763438" type="match_started" time="2025-11-02T00:10:15+00:00"/>
<event id="2182763478" type="inning_half_start" time="2025-11-02T00:10:18+00:00" inning_half="top"/>
<event id="2182763594" type="pitch_result" time="2025-11-02T00:10:27+00:00" inning_half="top" result="ball" count_balls="1" count_strikes="0" pitch_number="1">
<players>
<player id="sr:player:842773" name="Scherzer, Max" type="pitcher"/>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="batter"/>
</players>
</event>
<event id="2182763740" type="pitch_result" time="2025-11-02T00:10:46+00:00" inning_half="top" result="ball" count_balls="2" count_strikes="0" pitch_number="2">
<players>
<player id="sr:player:842773" name="Scherzer, Max" type="pitcher"/>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="batter"/>
</players>
</event>
<event id="2182763890" type="pitch_result" time="2025-11-02T00:11:03+00:00" inning_half="top" result="strike" count_balls="2" count_strikes="1" pitch_number="3">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="batter"/>
</players>
</event>
<event id="2182764190" type="ball_in_play" time="2025-11-02T00:11:22+00:00" inning_half="top" ball_in_play_type="unknown">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="batter"/>
</players>
</event>
<event id="2182764340" type="player_on_base" time="2025-11-02T00:11:35+00:00" on_base_type="single" starting_base="0" ending_base="1" count_balls="2" count_strikes="1" outs="0" errors="0">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="batter"/>
</players>
</event>
<event id="2182764572" type="pitch_result" time="2025-11-02T00:12:03+00:00" inning_half="top" result="strike" count_balls="0" count_strikes="1" pitch_number="1">
<players>
<player id="sr:player:1001655" name="Smith, Will" type="batter"/>
</players>
</event>
<event id="2182764730" type="pitch_result" time="2025-11-02T00:12:20+00:00" inning_half="top" result="strike" count_balls="0" count_strikes="2" pitch_number="2">
<players>
<player id="sr:player:1001655" name="Smith, Will" type="batter"/>
</players>
</event>
<event id="2182764954" type="ball_in_play" time="2025-11-02T00:12:44+00:00" inning_half="top" ball_in_play_type="unknown">
<players>
<player id="sr:player:1001655" name="Smith, Will" type="batter"/>
</players>
</event>
<event id="2182764978" type="player_out" time="2025-11-02T00:12:48+00:00" out_type="ground_out" out_base="0" count_balls="0" count_strikes="2" outs="1" errors="0">
<players>
<player id="sr:player:1001655" name="Smith, Will" type="batter"/>
</players>
</event>
<event id="2182765024" type="player_on_base" time="2025-11-02T00:12:55+00:00" on_base_type="unknown" starting_base="1" ending_base="2" count_balls="0" count_strikes="2" outs="1" errors="0">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="runner"/>
</players>
</event>
<event id="2182765352" type="ball_in_play" time="2025-11-02T00:13:29+00:00" inning_half="top" ball_in_play_type="unknown">
<players>
<player id="sr:player:841793" name="Freeman, Freddie" type="batter"/>
</players>
</event>
<event id="2182765404" type="player_out" time="2025-11-02T00:13:35+00:00" out_type="fly_out" out_base="0" count_balls="0" count_strikes="0" outs="2" errors="0">
<players>
<player id="sr:player:841793" name="Freeman, Freddie" type="batter"/>
</players>
</event>
<event id="2182765496" type="player_on_base" time="2025-11-02T00:13:45+00:00" on_base_type="unknown" starting_base="2" ending_base="3" count_balls="0" count_strikes="0" outs="2" errors="0">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="runner"/>
</players>
</event>
<event id="2182765836" type="pitch_result" time="2025-11-02T00:14:15+00:00" inning_half="top" result="ball" count_balls="1" count_strikes="0" pitch_number="1">
<players>
<player id="sr:player:842773" name="Scherzer, Max" type="pitcher"/>
<player id="sr:player:856712" name="Betts, Mookie" type="batter"/>
</players>
</event>
<event id="2182765962" type="ball_in_play" time="2025-11-02T00:14:33+00:00" inning_half="top" ball_in_play_type="unknown">
<players>
<player id="sr:player:856712" name="Betts, Mookie" type="batter"/>
</players>
</event>
<event id="2182765986" type="player_out" time="2025-11-02T00:14:37+00:00" out_type="ground_out" out_base="0" count_balls="1" count_strikes="0" outs="3" errors="0">
<players>
<player id="sr:player:856712" name="Betts, Mookie" type="batter"/>
</players>
</event>
<event id="2182766028" type="inning_half_start" time="2025-11-02T00:14:44+00:00"/>
<event id="2182768208" type="inning_half_start" time="2025-11-02T00:19:31+00:00" inning_half="bottom"/>
<event id="2182768376" type="pitch_result" time="2025-11-02T00:19:39+00:00" inning_half="bottom" result="ball" count_balls="1" count_strikes="0" pitch_number="1">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="pitcher"/>
<player id="sr:player:843127" name="Springer, George" type="batter"/>
</players>
</event>
<event id="2182768472" type="pitch_result" time="2025-11-02T00:19:52+00:00" inning_half="bottom" result="ball" count_balls="2" count_strikes="0" pitch_number="2">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="pitcher"/>
<player id="sr:player:843127" name="Springer, George" type="batter"/>
</players>
</event>
<event id="2182768608" type="pitch_result" time="2025-11-02T00:20:09+00:00" inning_half="bottom" result="ball" count_balls="3" count_strikes="0" pitch_number="3">
<players>
<player id="sr:player:1373965" name="Ohtani, Shohei" type="pitcher"/>
<player id="sr:player:843127" name="Springer, George" type="batter"/>
</players>
</event>
<event id="2182768742" type="pitch_result" time="2025-11-02T00:20:27+00:00" inning_half="bottom" result="strike" count_balls="3" count_strikes="1" pitch_number="4">
<players>
<player id="sr:player:843127" name="Springer, George" type="batter"/>
</players>
</event>
<event id="2182768858" type="ball_in_play" time="2025-11-02T00:20:42+00:00" inning_half="bottom" ball_in_play_type="unknown">
<players>
<player id="sr:player:843127" name="Springer, George" type="batter"/>
</players>
</event><statistics>
<totals>
<competitors>
<competitor id="sr:competitor:3642" name="Toronto Blue Jays" abbreviation="TOR" qualifier="home">
<statistics at_bats="43" earned_runs="5" errors="0" hits="14" hits_allowed="11" home_runs="1" innings_pitched="11" runs="4" runs_batted_in="4" saves="0" stolen_bases="1" strikeouts="5" walks="4" walks_allowed="5"/>
<players>
<player id="sr:player:842773" name="Scherzer, Max" type="pitcher">
<statistics at_bats="0" earned_runs="1" errors="0" hits="0" hits_allowed="4" home_runs="0" innings_pitched="4.1" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="3" walks="0" walks_allowed="1"/>
</player>
<player id="sr:player:843127" name="Springer, George" type="batter">
<statistics at_bats="6" earned_runs="0" errors="0" hits="3" hits_allowed="0" home_runs="0" innings_pitched="0" runs="1" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:854104" name="Bassitt, Chris" type="pitcher">
<statistics at_bats="0" earned_runs="1" errors="0" hits="0" hits_allowed="2" home_runs="0" innings_pitched="1" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="1"/>
</player>
<player id="sr:player:951814" name="Hoffman, Jeff" type="pitcher">
<statistics at_bats="0" earned_runs="1" errors="0" hits="0" hits_allowed="1" home_runs="0" innings_pitched="1.1" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="2" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1012451" name="Lukes, Nathan" type="batter">
<statistics at_bats="3" earned_runs="0" errors="0" hits="0" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1086172" name="Bieber, Shane" type="pitcher">
<statistics at_bats="0" earned_runs="1" errors="0" hits="0" hits_allowed="1" home_runs="0" innings_pitched="1" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1089356" name="Gimenez, Andres" type="batter">
<statistics at_bats="4" earned_runs="0" errors="0" hits="1" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="1" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1100805" name="Guerrero Jr., Vladimir" type="batter">
<statistics at_bats="5" earned_runs="0" errors="0" hits="1" hits_allowed="0" home_runs="0" innings_pitched="0" runs="1" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="1" walks_allowed="0"/>
</player>
<player id="sr:player:1100835" name="Bichette, Bo" type="batter">
<statistics at_bats="4" earned_runs="0" errors="0" hits="2" hits_allowed="0" home_runs="1" innings_pitched="0" runs="1" runs_batted_in="3" saves="0" stolen_bases="0" strikeouts="0" walks="1" walks_allowed="0"/>
</player>
<player id="sr:player:1108907" name="Kiner-Falefa, Isiah">
<statistics at_bats="0" earned_runs="0" errors="0" hits="0" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1358564" name="Dominguez, Seranthony" type="pitcher">
<statistics at_bats="0" earned_runs="0" errors="0" hits="0" hits_allowed="1" home_runs="0" innings_pitched="1" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="2"/>
</player>
<player id="sr:player:1396097" name="Varsho, Daulton" type="batter">
<statistics at_bats="5" earned_runs="0" errors="0" hits="0" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1402415" name="Straw, Myles" type="batter">
<statistics at_bats="1" earned_runs="0" errors="0" hits="0" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1479368" name="Clement, Ernie" type="batter">
<statistics at_bats="5" earned_runs="0" errors="0" hits="3" hits_allowed="0" home_runs="0" innings_pitched="0" runs="1" runs_batted_in="0" saves="0" stolen_bases="1" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1993847" name="Kirk, Alejandro" type="batter">
<statistics at_bats="5" earned_runs="0" errors="0" hits="2" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:1993931" name="Schneider, Davis" type="batter">
<statistics at_bats="1" earned_runs="0" errors="0" hits="0" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:2283437" name="Varland, Louie" type="pitcher">
<statistics at_bats="0" earned_runs="0" errors="0" hits="0" hits_allowed="1" home_runs="0" innings_pitched="0.2" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:2290897" name="Barger, Addison" type="batter">
<statistics at_bats="4" earned_runs="0" errors="0" hits="2" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="2" walks_allowed="0"/>
</player>
<player id="sr:player:2402881" name="Fluharty, Mason">
<statistics at_bats="0" earned_runs="0" errors="0" hits="0" hits_allowed="0" home_runs="0" innings_pitched="0" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="0"/>
</player>
<player id="sr:player:2801271" name="Yesavage, Trey" type="pitcher">
<statistics at_bats="0" earned_runs="1" errors="0" hits="0" hits_allowed="1" home_runs="0" innings_pitched="1.2" runs="0" runs_batted_in="0" saves="0" stolen_bases="0" strikeouts="0" walks="0" walks_allowed="1"/>
</player>
</players>
</competitor>Standings Enhancements
| Release Date | Endpoints | Benefit |
|---|---|---|
| 03/03/2026 | Season Standings | We’ve added six (6) new standings data points to our Global Baseball API. New standings stats are: Home Win/Loss Record, Away Win/Loss Record, Last 10 games played Win/Loss record. With this update, you can capture and provide more robust standings breakdowns for the major Korean and Japanese baseball leagues (KBO & NPB). Display each team's home/away records as well as their record over the last 10 games played. |
{
"generated_at": "2026-03-03T18:19:35+00:00",
"standings":
[
{
"tie_break_rule": "The MLB overall table is sorted by percentage",
"type": "total",
"groups":
[
{
"stage":
{
"order": 1,
"type": "league",
"phase": "regular season",
"start_date": "2025-03-18",
"end_date": "2025-09-28",
"year": "2025"
},
"id": "sr:league:88673",
"name": "MLB",
"live": false,
"standings":
[
{
"rank": 1,
"played": 162,
"win": 97,
"loss": 65,
"draw": 0,
"runs_for": 806,
"runs_against": 634,
"runs_diff": 172,
"competitor":
{
"id": "sr:competitor:3630",
"name": "Milwaukee Brewers",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIL",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 0,
"winning_percentage": 0.599,
"win_home": 52,
"loss_home": 29,
"win_away": 45,
"loss_away": 36,
"win_last_ten": 4,
"loss_last_ten": 6
},
{
"rank": 2,
"played": 162,
"win": 96,
"loss": 66,
"draw": 0,
"runs_for": 778,
"runs_against": 648,
"runs_diff": 130,
"competitor":
{
"id": "sr:competitor:3635",
"name": "Philadelphia Phillies",
"country": "USA",
"country_code": "USA",
"abbreviation": "PHI",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 1,
"winning_percentage": 0.593,
"win_home": 55,
"loss_home": 26,
"win_away": 41,
"loss_away": 40,
"win_last_ten": 5,
"loss_last_ten": 5
},
{
"rank": 3,
"played": 162,
"win": 94,
"loss": 68,
"draw": 0,
"runs_for": 849,
"runs_against": 685,
"runs_diff": 164,
"competitor":
{
"id": "sr:competitor:3654",
"name": "New York Yankees",
"country": "USA",
"country_code": "USA",
"abbreviation": "NYY",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 3,
"winning_percentage": 0.58,
"win_home": 50,
"loss_home": 31,
"win_away": 44,
"loss_away": 37,
"win_last_ten": 9,
"loss_last_ten": 1
},
{
"rank": 4,
"played": 162,
"win": 94,
"loss": 68,
"draw": 0,
"runs_for": 798,
"runs_against": 721,
"runs_diff": 77,
"competitor":
{
"id": "sr:competitor:3642",
"name": "Toronto Blue Jays",
"country": "USA",
"country_code": "USA",
"abbreviation": "TOR",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 3,
"winning_percentage": 0.58,
"win_home": 54,
"loss_home": 27,
"win_away": 40,
"loss_away": 41,
"win_last_ten": 5,
"loss_last_ten": 5
},
{
"rank": 5,
"played": 162,
"win": 93,
"loss": 69,
"draw": 0,
"runs_for": 825,
"runs_against": 683,
"runs_diff": 142,
"competitor":
{
"id": "sr:competitor:3638",
"name": "Los Angeles Dodgers",
"country": "USA",
"country_code": "USA",
"abbreviation": "LAD",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 4,
"winning_percentage": 0.574,
"win_home": 52,
"loss_home": 29,
"win_away": 41,
"loss_away": 40,
"win_last_ten": 8,
"loss_last_ten": 2
}, <season_standing tie_break_rule="The MLB overall table is sorted by percentage" type="total" round="1">
<groups>
<group id="sr:league:88673" name="MLB" live="false">
<stage order="1" type="league" phase="regular season" start_date="2025-03-18" end_date="2025-09-28" year="2025"/>
<standings>
<standing rank="1" played="162" win="97" loss="65" draw="0" runs_for="806" runs_against="634" runs_diff="172" current_outcome="Playoffs" games_behind="0" winning_percentage="0.599" win_home="52" loss_home="29" win_away="45" loss_away="36" win_last_ten="4" loss_last_ten="6">
<competitor id="sr:competitor:3630" name="Milwaukee Brewers" country="USA" country_code="USA" abbreviation="MIL" gender="male"/>
</standing>
<standing rank="2" played="162" win="96" loss="66" draw="0" runs_for="778" runs_against="648" runs_diff="130" current_outcome="Playoffs" games_behind="1" winning_percentage="0.593" win_home="55" loss_home="26" win_away="41" loss_away="40" win_last_ten="5" loss_last_ten="5">
<competitor id="sr:competitor:3635" name="Philadelphia Phillies" country="USA" country_code="USA" abbreviation="PHI" gender="male"/>
</standing>
<standing rank="3" played="162" win="94" loss="68" draw="0" runs_for="849" runs_against="685" runs_diff="164" current_outcome="Playoffs" games_behind="3" winning_percentage="0.58" win_home="50" loss_home="31" win_away="44" loss_away="37" win_last_ten="9" loss_last_ten="1">
<competitor id="sr:competitor:3654" name="New York Yankees" country="USA" country_code="USA" abbreviation="NYY" gender="male"/>
</standing>
<standing rank="4" played="162" win="94" loss="68" draw="0" runs_for="798" runs_against="721" runs_diff="77" current_outcome="Playoffs" games_behind="3" winning_percentage="0.58" win_home="54" loss_home="27" win_away="40" loss_away="41" win_last_ten="5" loss_last_ten="5">
<competitor id="sr:competitor:3642" name="Toronto Blue Jays" country="USA" country_code="USA" abbreviation="TOR" gender="male"/>
</standing>
<standing rank="5" played="162" win="93" loss="69" draw="0" runs_for="825" runs_against="683" runs_diff="142" current_outcome="Playoffs" games_behind="4" winning_percentage="0.574" win_home="52" loss_home="29" win_away="41" loss_away="40" win_last_ten="8" loss_last_ten="2">
<competitor id="sr:competitor:3638" name="Los Angeles Dodgers" country="USA" country_code="USA" abbreviation="LAD" gender="male"/>
</standing>Games Behind Adjustment
| Release Date | Endpoints | Benefit |
|---|---|---|
| 08/05/2025 | Season Standings | The games_behind attribute is now hidden in the Season Standings endpoint of our Global Baseball API when it's not supported. Currently, this attribute is only available for MLB and MiLB seasons. |
{
"generated_at": "2025-08-05T14:07:35+00:00",
"standings": [
{
"tie_break_rule": "The MLB overall table is sorted by percentage",
"type": "total",
"groups": [
{
"stage": {
"order": 1,
"type": "league",
"phase": "regular season",
"start_date": "2024-03-20",
"end_date": "2024-10-01",
"year": "2024"
},
"id": "sr:league:80909",
"name": "MLB",
"live": false,
"standings": [
{
"rank": 1,
"played": 162,
"win": 98,
"loss": 64,
"draw": 0,
"runs_for": 842,
"runs_against": 686,
"runs_diff": 156,
"competitor": {
"id": "sr:competitor:3638",
"name": "Los Angeles Dodgers",
"country": "USA",
"country_code": "USA",
"abbreviation": "LAD",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 0,
"winning_percentage": 0.605
},
{
"rank": 2,
"played": 162,
"win": 95,
"loss": 67,
"draw": 0,
"runs_for": 784,
"runs_against": 671,
"runs_diff": 113,
"competitor": {
"id": "sr:competitor:3635",
"name": "Philadelphia Phillies",
"country": "USA",
"country_code": "USA",
"abbreviation": "PHI",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 3,
"winning_percentage": 0.586
},
{
"rank": 3,
"played": 162,
"win": 94,
"loss": 68,
"draw": 0,
"runs_for": 815,
"runs_against": 668,
"runs_diff": 147,
"competitor": {
"id": "sr:competitor:3654",
"name": "New York Yankees",
"country": "USA",
"country_code": "USA",
"abbreviation": "NYY",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 4,
"winning_percentage": 0.58
},
{
"rank": 4,
"played": 162,
"win": 93,
"loss": 69,
"draw": 0,
"runs_for": 777,
"runs_against": 641,
"runs_diff": 136,
"competitor": {
"id": "sr:competitor:3630",
"name": "Milwaukee Brewers",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIL",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 5,
"winning_percentage": 0.574
},
{
"rank": 5,
"played": 162,
"win": 93,
"loss": 69,
"draw": 0,
"runs_for": 760,
"runs_against": 669,
"runs_diff": 91,
"competitor": {
"id": "sr:competitor:3636",
"name": "San Diego Padres",
"country": "USA",
"country_code": "USA",
"abbreviation": "SD",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 5,
"winning_percentage": 0.574
},
{
"rank": 6,
"played": 161,
"win": 92,
"loss": 69,
"draw": 0,
"runs_for": 708,
"runs_against": 621,
"runs_diff": 87,
"competitor": {
"id": "sr:competitor:3650",
"name": "Cleveland Guardians",
"country": "USA",
"country_code": "USA",
"abbreviation": "CLE",
"gender": "male"
},
"current_outcome": "Playoffs",
"games_behind": 5.5,
"winning_percentage": 0.571
},<season_standing tie_break_rule="The MLB overall table is sorted by percentage" type="total" round="1">
<groups>
<group id="sr:league:80909" name="MLB" live="false">
<stage order="1" type="league" phase="regular season" start_date="2024-03-20" end_date="2024-10-01" year="2024"/>
<standings>
<standing rank="1" played="162" win="98" loss="64" draw="0" runs_for="842" runs_against="686" runs_diff="156" current_outcome="Playoffs" games_behind="0" winning_percentage="0.605">
<competitor id="sr:competitor:3638" name="Los Angeles Dodgers" country="USA" country_code="USA" abbreviation="LAD" gender="male"/>
</standing>
<standing rank="2" played="162" win="95" loss="67" draw="0" runs_for="784" runs_against="671" runs_diff="113" current_outcome="Playoffs" games_behind="3" winning_percentage="0.586">
<competitor id="sr:competitor:3635" name="Philadelphia Phillies" country="USA" country_code="USA" abbreviation="PHI" gender="male"/>
</standing>
<standing rank="3" played="162" win="94" loss="68" draw="0" runs_for="815" runs_against="668" runs_diff="147" current_outcome="Playoffs" games_behind="4" winning_percentage="0.58">
<competitor id="sr:competitor:3654" name="New York Yankees" country="USA" country_code="USA" abbreviation="NYY" gender="male"/>
</standing>
<standing rank="4" played="162" win="93" loss="69" draw="0" runs_for="777" runs_against="641" runs_diff="136" current_outcome="Playoffs" games_behind="5" winning_percentage="0.574">
<competitor id="sr:competitor:3630" name="Milwaukee Brewers" country="USA" country_code="USA" abbreviation="MIL" gender="male"/>
</standing>
<standing rank="5" played="162" win="93" loss="69" draw="0" runs_for="760" runs_against="669" runs_diff="91" current_outcome="Playoffs" games_behind="5" winning_percentage="0.574">
<competitor id="sr:competitor:3636" name="San Diego Padres" country="USA" country_code="USA" abbreviation="SD" gender="male"/>
</standing>
<standing rank="6" played="161" win="92" loss="69" draw="0" runs_for="708" runs_against="621" runs_diff="87" current_outcome="Playoffs" games_behind="5.5" winning_percentage="0.571">
<competitor id="sr:competitor:3650" name="Cleveland Guardians" country="USA" country_code="USA" abbreviation="CLE" gender="male"/>
</standing>
<standing rank="7" played="162" win="91" loss="71" draw="0" runs_for="786" runs_against="699" runs_diff="87" current_outcome="Playoffs" games_behind="7" winning_percentage="0.562">
<competitor id="sr:competitor:3652" name="Baltimore Orioles" country="USA" country_code="USA" abbreviation="BAL" gender="male"/>
</standing>Neutral Ground Signifier
| Release Date | Endpoints | Benefit |
|---|---|---|
| 08/19/2024 | All Summary Endpoints All Sport Event Endpoints Sport Event Timeline | We've added a neutral ground signifier to all games in the API. All 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 Date | Endpoints | Benefit |
|---|---|---|
| 05/08/2024 | Competitor Profile Summaries Endpoints Timeline Endpoints | We have added venue information for the following leagues:
|
<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 Date | Endpoints | Benefit |
|---|---|---|
| 03/21/2024 | Summary & Timeline Endpoints | We 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 Date | Endpoints | Benefit |
|---|---|---|
| 02/26/2024 | 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 | Made the following updates to coverage level properties. For endpoints containing Sport Events info: Removed the sport_event_properties node into coverage with the following attributes:
|
<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 Date | Endpoints | Benefit |
|---|---|---|
| 02/16/2024 | All | We have added coverage for NCAA Women's Softball for the 2024 season! All softball competitions can be accessed by changing the 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 Date | Feeds Affected | Benefit |
|---|---|---|
| 08/28/2023 | Sport Events Created | Added 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 Date | Feeds Affected | Benefit |
| 03/20/2023 | Season Links | Added 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 Date | Feeds Affected | Benefit |
| 03/13/2023 | Competitor 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 Date | Feeds Affected | Benefit |
| 03/03/2023 | Season Probabilities | Added 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 Date | Feeds Affected | Benefit |
| 01/20/2023 | Competition Info | Added 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 Date | Feeds Affected | Benefit |
| 08/23/2022 | Competitor 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 Date | Feeds Affected | Benefit |
| 06/29/2022 | Sport Events Created | Our 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 Date | Feeds Affected | Benefit |
| 12/09/2021 | Competition 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 Date | Feeds Affected | Benefit |
| 11/04/2021 | Competition 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 Date | Feeds Affected | Benefit |
| 10/15/2021 | Daily 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 Date | Feeds Affected | Benefit |
| 09/10/2021 | Season Competitors Season Links Season Players | Added data points to support the addition of three seasonal statistic feeds. |
Probabilities Package
| Release Date | Feeds Affected | Benefit |
| 03/10/2021 | Live 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 Date | Feeds Affected | Benefit |
| 02/19/2021 | Competitor 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 Date | Feeds Affected | Benefit |
| 05/13/2020 | Season Info | Added the following data points: competition_status, venue_reduced_capacity, and venue_reduced_capacity_max. |
Venue Data
| Release Date | Feeds Affected | Benefit |
| 05/13/2020 | Competitor 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 Date | Feeds Affected | Benefit |
| 06/04/2019 | Competitor 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 Date | Feeds Affected | Benefit |
| 05/13/2019 | All | Initial release of Global Baseball v2 |