--- updatedAt: 2026-10-01T19:44:35.000Z agentTools: siteIndex: https://developer.sportradar.com/llms.txt projectIndex: https://developer.sportradar.com/baseball/llms.txt --- # Change Log Archive Older updates, grouped by release year Older updates, grouped by release year. For the most recent updates, see the Change Log. *** ## 2025 ### Games Played Calculation

Release Date	Feeds Affected	Benefit
07/24/2025	Game Summary Game Extended Summary	We've updated the calculation for the data point of games played for overall fielding under each player. The calculation is now a maximum of a single "games played" value for a player's overall fielding statistics. Why It Matters This update ensures that the games played count for a player's overall fielding is consistent with standard baseball conventions. By removing inflated totals caused by multi-position appearances in a single game, we provide more accurate, trustworthy data to support downstream use cases. What You Need to Do No change is needed. The 2024 and 2025 seasons will be updated accordingly, while former seasons will be addressed at a later date.

```xml Players Sample ``` ```json Tournament Schedule Sample { "tour": { "id": "b52068af-28e4-4e91-bdbb-037591b0ff84", "alias": "pga", "name": "PGA Tour" }, "season": { "id": "eb67f38a-283b-4e7a-97b4-9fac0ee092e0", "year": 2025 }, "tournaments": [ { "id": "2eadcc26-4378-4d53-bd0a-f73962983137", "name": "The Sentry", "event_type": "stroke", "purse": 20000000.0, "currency": "USD", "points": 700, "start_date": "2025-01-02", "end_date": "2025-01-05", "course_timezone": "Pacific/Honolulu", "network": "NBC, Golf Channel", "total_rounds": 4, "status": "closed", "parent_id": "bd5b1a78-eb4a-4d3e-86a6-541801b82e51", "scoring_system": "stroke", "defending_champ": { "id": "e4f92dca-86d5-441e-8a2d-55d5360937c5", "first_name": "Chris", "last_name": "Kirk", "height": 75, "weight": 175, "birthday": "1985-05-08", "country": "UNITED STATES", "residence": "St. Simons Island, GA, USA", "birth_place": "Knoxville, TN, USA", "college": "Georgia", "turned_pro": 2007, "handedness": "R", "abbr_name": "C.Kirk", "amateur": false, "gender": "male" }, "winner": { "id": "d45bcf4a-5803-4b0b-ab6c-6427a76cecf7", "first_name": "Hideki", "last_name": "Matsuyama", "height": 71, "weight": 198, "birthday": "1992-02-25T00:00:00+00:00", "country": "JAPAN", "residence": "Sendai,, JPN", "birth_place": "Ehime,, JPN", "college": "Tohoku Fukushi", "turned_pro": 2013, "handedness": "R", "abbr_name": "H.Matsuyama", "name": "Matsuyama, Hideki", "gender": "male" }, ``` ***
### Season Teams Sort in Player Profile

Release Date	Feeds Affected	Benefit
06/27/2025	Player Profile	We've adjusted the behavior of our [Player Profile](https://developer.sportradar.com/baseball/reference/mlb-player-profile) endpoint to always sort each `season` entry to display the most recent team first. You may now use this endpoint to reliably infer the current team for a player. In the below example, Rafael Devers was traded from the Red Sox to the Giants in the 2025 regular season. The 2025 regular season entry (`season id="a91f72a5-9812-4acd-b3fd-482cb31468cd" year="2024" type="REG"`) displays his Giants statistics first, indicating it was the last team he recorded statistics for in the 2025 regular season. Sample Request: `mlb/trial/v8/en/players/fe966998-15e1-4022-89d5-6b4750516176/profile.json`

```json Sample Snippet (json) { "player": { "id": "fe966998-15e1-4022-89d5-6b4750516176", "status": "A", "position": "DH", "primary_position": "DH", "first_name": "Rafael", "last_name": "Devers", "preferred_name": "Rafael", "jersey_number": "16", "full_name": "Rafael Devers", "height": "72", "weight": "235", "throw_hand": "R", "bat_hand": "L", "birthdate": "1996-10-24", "birthcountry": "DOM", "birthcity": "Sanchez", "pro_debut": "2017-07-25", "updated": "2025-06-18T13:27:07+00:00", "salary": 31318182, "rookie_year": 2017, "reference": "646240", "team": { "name": "Giants", "market": "San Francisco", "abbr": "SF", "id": "a7723160-10b7-4277-a309-d8dd95a8ae65" }, "seasons": [ { "id": "a91f72a5-9812-4acd-b3fd-482cb31468cd", "year": 2025, "type": "REG", "teams": [ { "name": "Giants", "market": "San Francisco", "abbr": "SF", "id": "a7723160-10b7-4277-a309-d8dd95a8ae65", "statistics": { "hitting": { "overall": { "ab": 35, "lob": 10, "rbi": 5, "abhr": 17.5, "abk": 3.889, "bip": 24, "babip": 0.292, "bbk": 0.556, "bbpa": 0.125, "iso": 0.229, "obp": 0.35, "ops": 0.836, "seca": 0.371, "slg": 0.486, "xbh": 4, "pitch_count": 152, "lob_risp_2out": 0, "team_lob": 0, "ab_risp": 3, "hit_risp": 0, "rbi_2out": 2, "linedrive": 3, "groundball": 13, "popup": 1, "flyball": 9, "ap": 40, "avg": ".257", "gofo": 1.43, "woba": 0.364208, "wraa": 1.62073, "war": 0.13782, "bwar": 1.68271, "fwar": 0, "brwar": -0.684725, "wgdp": 0, "wrc": 6.23598, "wrc_plus": 135.993, "onbase": { "s": 5, "d": 2, "t": 0, "hr": 2, "tb": 17, "bb": 5, "ibb": 0, "hbp": 0, "fc": 1, "roe": 0, "h": 9, "ci": 0, "rov": 0, "cycle": 0 }, "runs": { "total": 3 }, "outcome": { "klook": 20, "kswing": 19, "ktotal": 39, "ball": 53, "iball": 0, "dirtball": 5, "foul": 29 }, "outs": { "po": 1, "fo": 6, "fidp": 0, "lo": 0, "lidp": 0, "go": 10, "gidp": 0, "klook": 2, "kswing": 7, "ktotal": 9, "sacfly": 0, "sachit": 0 }, "steal": { "caught": 0, "stolen": 0, "pct": 0, "pickoff": 0 }, "pitches": { "count": 152, "btotal": 58, "ktotal": 94 }, "games": { "start": 9, "play": 9, "finish": 0, "complete": 9 } } } }, "splits": { "hitting": { "overall": [ { "total": [ { "ab": 35, "runs": 3, "s": 5, "d": 2, "t": 0, "hr": 2, "rbi": 5, "bb": 5, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.35, "slg": 0.486, "ops": 0.836, "h": 9, "ktotal": 9, "avg": ".257" } ], "day_night": [ { "value": "night", "ab": 21, "runs": 0, "s": 2, "d": 1, "t": 0, "hr": 0, "rbi": 1, "bb": 2, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.217, "slg": 0.19, "ops": 0.407, "h": 3, "ktotal": 5, "avg": ".143" }, { "value": "day", "ab": 14, "runs": 3, "s": 3, "d": 1, "t": 0, "hr": 2, "rbi": 4, "bb": 3, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.529, "slg": 0.929, "ops": 1.458, "h": 6, "ktotal": 4, "avg": ".429" } ], "venue": [ { "id": "2d7542f5-7b80-49f7-9b24-c53ffdc75af6", "name": "Oracle Park", "market": "San Francisco", "surface": "grass", "ab": 35, "runs": 3, "s": 5, "d": 2, "t": 0, "hr": 2, "rbi": 5, "bb": 5, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.35, "slg": 0.486, "ops": 0.836, "h": 9, "ktotal": 9, "avg": ".257" } ], "surface": [ { "value": "grass", "ab": 35, "runs": 3, "s": 5, "d": 2, "t": 0, "hr": 2, "rbi": 5, "bb": 5, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.35, "slg": 0.486, "ops": 0.836, "h": 9, "ktotal": 9, "avg": ".257" } ], "month": [ { "value": "6", "ab": 35, "runs": 3, "s": 5, "d": 2, "t": 0, "hr": 2, "rbi": 5, "bb": 5, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.35, "slg": 0.486, "ops": 0.836, "h": 9, "ktotal": 9, "avg": ".257" } ], "home_away": [ { "value": "home", "ab": 35, "runs": 3, "s": 5, "d": 2, "t": 0, "hr": 2, "rbi": 5, "bb": 5, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.35, "slg": 0.486, "ops": 0.836, "h": 9, "ktotal": 9, "avg": ".257" } ], "pitcher_hand": [ { "value": "R", "ab": 25, "runs": 2, "s": 4, "d": 2, "t": 0, "hr": 2, "rbi": 5, "bb": 3, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.393, "slg": 0.64, "ops": 1.033, "h": 8, "ktotal": 5, "avg": ".320" }, { "value": "L", "ab": 10, "runs": 1, "s": 1, "d": 0, "t": 0, "hr": 0, "rbi": 0, "bb": 2, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.25, "slg": 0.1, "ops": 0.35, "h": 1, "ktotal": 4, "avg": ".100" } ], "opponent": [ { "id": "03556285-bdbb-4576-a06d-42f71f46ddc5", "name": "Marlins", "market": "Miami", "abbr": "MIA", "ab": 12, "runs": 1, "s": 2, "d": 1, "t": 0, "hr": 1, "rbi": 2, "bb": 2, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.429, "slg": 0.667, "ops": 1.096, "h": 4, "ktotal": 2, "avg": ".333" }, { "id": "93941372-eb4c-4c40-aced-fe3267174393", "name": "Red Sox", "market": "Boston", "abbr": "BOS", "ab": 12, "runs": 2, "s": 1, "d": 0, "t": 0, "hr": 1, "rbi": 2, "bb": 1, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.231, "slg": 0.417, "ops": 0.648, "h": 2, "ktotal": 3, "avg": ".167" }, { "id": "80715d0d-0d2a-450f-a970-1b9a3b18c7e7", "name": "Guardians", "market": "Cleveland", "abbr": "CLE", "ab": 11, "runs": 0, "s": 2, "d": 1, "t": 0, "hr": 0, "rbi": 1, "bb": 2, "ibb": 0, "hbp": 0, "sb": 0, "cs": 0, "obp": 0.385, "slg": 0.364, "ops": 0.749, "h": 3, "ktotal": 4, "avg": ".273" } ] } ] } } }, { "name": "Red Sox", "market": "Boston", "abbr": "BOS", "id": "93941372-eb4c-4c40-aced-fe3267174393", "statistics": { "hitting": { "overall": { "ab": 272, "lob": 118, "rbi": 58, "abhr": 18.133, "abk": 3.579, "bip": 183, "babip": 0.322, "bbk": 0.737, "bbpa": 0.168, "iso": 0.232, "obp": 0.401, "ops": 0.905, "seca": 0.438, "slg": 0.504, "xbh": 33, "pitch_count": 1389, "lob_risp_2out": 26, "team_lob": 47, "ab_risp": 78, "hit_risp": 23, "rbi_2out": 19, "linedrive": 47, "groundball": 82, "popup": 10, "flyball": 59, "ap": 334, "avg": ".272", "gofo": 1.11, "woba": 0.388478, "wraa": 20.0013, "war": 2.07209, "bwar": 18.2137, "fwar": 0, "brwar": -1.51289, "wgdp": 0, "wrc": 58.5386, "wrc_plus": 147.876, "onbase": { "s": 41, "d": 18, "t": 0, "hr": 15, "tb": 137, "bb": 49, "ibb": 7, "hbp": 4, "fc": 5, "roe": 2, "h": 74, "ci": 0, "rov": 0, "cycle": 0 }, "runs": { "total": 47 }, "outcome": { "klook": 150, "kswing": 224, "ktotal": 374, "ball": 521, "iball": 0, "dirtball": 35, "foul": 257 }, "outs": { "po": 10, "fo": 34, "fidp": 0, "lo": 18, "lidp": 0, "go": 69, "gidp": 7, "klook": 16, "kswing": 60, "ktotal": 76, "sacfly": 2, "sachit": 0 }, "steal": { "caught": 1, "stolen": 1, "pct": 0.5, "pickoff": 0 }, "pitches": { "count": 1389, "btotal": 560, "ktotal": 829 }, "games": { "start": 73, "play": 73, "finish": 0, "complete": 71 } } } }, --snip-- }, ``` ```xml Sample Snippet (xml) --snip-- ``` ***
### Deprecated Seasonal Transactions Endpoint

Release Date	Feeds Affected	Benefit
06/25/2025	Seasonal Transactions	We've deprecated the Seasonal Transactions endpoint. You may continue to access transactional data in the [Daily Transactions](https://developer.sportradar.com/baseball/reference/mlb-daily-transactions) endpoint.

***
### Times Through the Order

Release Date	Feeds Affected	Benefit
04/15/2025	Daily Summary Game Extended Summary Game Summary	We've added a data point for the number of times a pitcher has pitched through the order in a game. This is available by game under `times_through_order` in each Summary endpoint, at the player level only.

```xml Daily Summary Snippet (xml) ``` ```json Daily Summary Snippet (json) { "preferred_name": "Joe", "first_name": "Joseph", "last_name": "Ryan", "jersey_number": "41", "id": "957523c6-5d2f-43f2-804f-a8dbb73c8c16", "full_name": "Joe Ryan", "status": "A", "position": "P", "primary_position": "SP", "statistics": { "pitching": { "overall": { "oba": 0.167, "lob": 10, "era": 1.8, "k9": 14.4, "whip": 1.0, "kbb": 4.0, "pitch_count": 101, "wp": 0, "bk": 0, "ip_1": 15, "ip_2": 5.0, "bf": 20, "gofo": 0.75, "babip": 0.3, "bf_ip": 4.0, "bf_start": 20.0, "gbfb": 1.5, "oab": 18, "slg": 0.278, "obp": 0.25, "times_through_order": 2, "onbase": { "s": 1, "d": 2, "t": 0, "hr": 0, "tb": 5, "bb": 2, "ibb": 0, "hbp": 0, "fc": 0, "roe": 0, "h": 3, "ci": 0, "rov": 0, "h9": 5.4, "hr9": 0.0 }, "runs": { "total": 1, "unearned": 0, "earned": 1, "ir": 0, "ira": 0, "bqr": 0, "bqra": 0 }, "outcome": { "klook": 16, "kswing": 16, "ktotal": 32, "ball": 29, "iball": 0, "dirtball": 7, "foul": 23 }, "outs": { "po": 3, "fo": 1, "fidp": 0, "lo": 0, "lidp": 0, "go": 3, "gidp": 0, "klook": 1, "kswing": 7, "ktotal": 8, "sacfly": 0, "sachit": 0 }, "steal": { "caught": 0, "stolen": 1, "pickoff": 0 }, "pitches": { "count": 101, "btotal": 36, "ktotal": 65, "per_ip": 20.2, "per_bf": 5.05, "per_start": 101.0 }, "in_play": { "linedrive": 2, "groundball": 3, "popup": 3, "flyball": 2 }, "games": { "start": 1, "play": 1, "finish": 0, "svo": 0, "qstart": 0, "shutout": 0, "complete": 0, "win": 0, "loss": 0, "save": 0, "hold": 0, "blown_save": 0, "team_win": 0, "team_loss": 1 } }, "starters": { "oba": 0.167, "lob": 10, "era": 1.8, "k9": 14.4, "whip": 1.0, "kbb": 4.0, "pitch_count": 101, "wp": 0, "bk": 0, "ip_1": 15, "ip_2": 5.0, "bf": 20, "gofo": 0.75, "babip": 0.3, "bf_ip": 4.0, "bf_start": 20.0, "gbfb": 1.5, "oab": 18, "slg": 0.278, "obp": 0.25, "times_through_order": 2, "onbase": { "s": 1, "d": 2, "t": 0, "hr": 0, "tb": 5, "bb": 2, "ibb": 0, "hbp": 0, "fc": 0, "roe": 0, "h": 3, "ci": 0, "rov": 0, "h9": 5.4, "hr9": 0.0 }, "runs": { "total": 1, "unearned": 0, "earned": 1, "ir": 0, "ira": 0, "bqr": 0, "bqra": 0 }, "outcome": { "klook": 16, "kswing": 16, "ktotal": 32, "ball": 29, "iball": 0, "dirtball": 7, "foul": 23 }, "outs": { "po": 3, "fo": 1, "fidp": 0, "lo": 0, "lidp": 0, "go": 3, "gidp": 0, "klook": 1, "kswing": 7, "ktotal": 8, "sacfly": 0, "sachit": 0 }, "steal": { "caught": 0, "stolen": 1, "pickoff": 0 }, "pitches": { "count": 101, "btotal": 36, "ktotal": 65, "per_ip": 20.2, "per_bf": 5.05, "per_start": 101.0 }, "in_play": { "linedrive": 2, "groundball": 3, "popup": 3, "flyball": 2 }, "games": { "start": 1, "play": 1, "finish": 0, "svo": 0, "qstart": 0, "shutout": 0, "complete": 0, "win": 0, "loss": 0, "save": 0, "hold": 0, "blown_save": 0, "team_win": 0, "team_loss": 1 } } }, "fielding": { "overall": { "po": 0, "a": 1, "dp": 0, "tp": 0, "error": 0, "tc": 1, "fpct": 1.0, "c_wp": 0, "pb": 0, "rf": 1.0, "inn_1": 15, "inn_2": 5.0, "steal": { "caught": 0, "stolen": 0, "pickoff": 0, "pct": 0 }, "errors": { "throwing": 0, "fielding": 0, "interference": 0, "total": 0 }, "assists": { "outfield": 0, "total": 1 }, "games": { "start": 1, "play": 1, "finish": 0, "complete": 0 } }, "positions": [ { "po": 0, "a": 1, "dp": 0, "tp": 0, "error": 0, "tc": 1, "fpct": 1.0, "c_wp": 0, "pb": 0, "rf": 1.0, "inn_1": 15, "inn_2": 5.0, "position": "P", "steal": { "caught": 0, "stolen": 0, "pickoff": 0, "pct": 0 }, "errors": { "throwing": 0, "fielding": 0, "interference": 0, "total": 0 }, "assists": { "outfield": 0, "total": 1 }, "games": { "start": 1, "play": 1, "finish": 0, "complete": 0 } } ] } } }, ``` ***
### Catcher's Interference & Reached on Violation

Release Date	Feeds Affected	Benefit
04/14/2025	Daily Summary Game Extended Summary Game Play-by-Play Game Summary Player Profile Seasonal Statistics	We've added data points for batters reaching base on catcher's interference and on violation (ex. reaching on a shift violation). Values will be available at the game and seasonal level, for players and teams. `ci` - Catcher's interference `rov` - Reached on violation In the [Game Play-by-Play](https://developer.sportradar.com/baseball/reference/mlb-play-by-play) endpoint, these instances are noted with the following outcome ids: - _Catcher's Interference:_\* `outcome_id="aCI"` - _Reached on Violation:_ \*`outcome_id="aROV"` These changes are in effect for MLB API versions 6.5 through 8. See below for MLB v8 sample data.

```xml Play-by-Play Snippet (xml) Jon Berti reaches on catcher interference. ``` ```json Play-by-Play Snippet (json) { "at_bat":{ "hitter_id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "id":"832129ce-59f3-4013-a6c7-70bebc6c96c1", "hitter_hand":"R", "pitcher_id":"fe45e33b-f554-4856-af56-1f4f578eaa82", "pitcher_hand":"R", "sequence_number":383, "description":"Carson Kelly reaches on violation error. Violation error by Miguel Rojas.", "hitter":{ "preferred_name":"Carson", "first_name":"Carson", "last_name":"Kelly", "jersey_number":"15", "id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "full_name":"Carson Kelly" }, "pitcher":{ "preferred_name":"Kirby", "first_name":"Kirby", "last_name":"Yates", "jersey_number":"38", "id":"fe45e33b-f554-4856-af56-1f4f578eaa82", "full_name":"Kirby Yates" }, "score":{ "home_team_runs":3, "away_team_runs":6 }, "events":[ { "status":"official", "id":"54159e80-a35f-4272-b79e-ca2c7188c9af", "outcome_id":"kKS", "created_at":"2025-03-19T12:30:40+00:00", "updated_at":"2025-03-19T12:33:01+00:00", "sequence_number":384, "official":true, "type":"pitch", "wall_clock":{ "start_time":"2025-03-19T12:27:51+00:00", "end_time":"2025-03-19T12:28:07+00:00" }, "flags":{ "is_ab_over":false, "is_bunt":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":0, "strikes":1, "outs":2, "pitch_count":1 }, "pitcher":{ "pitch_type":"FA", "pitch_speed":92.9, "pitch_zone":2, "pitcher_hand":"R", "hitter_hand":"R", "pitch_count":11, "id":"fe45e33b-f554-4856-af56-1f4f578eaa82", "pitch_x":-35, "pitch_y":60, "preferred_name":"Kirby", "first_name":"Kirby", "last_name":"Yates", "jersey_number":"38", "full_name":"Kirby Yates" }, "hitter":{ "preferred_name":"Carson", "first_name":"Carson", "last_name":"Kelly", "jersey_number":"15", "id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "full_name":"Carson Kelly" }, "score":{ "home_team_runs":3, "away_team_runs":6 }, "mlb_pitch_data":{ "speed":92.9, "strike_zone_top":3.33, "strike_zone_bottom":1.66, "zone":2, "code":"FF", "description":"Four-Seam Fastball", "coordinates":{ "x":108.04, "y":158.12 } } }, { "status":"official", "id":"442a008e-77f5-49a5-83fe-8d21ccb0a616", "outcome_id":"bB", "created_at":"2025-03-19T12:30:41+00:00", "updated_at":"2025-03-19T12:30:41+00:00", "sequence_number":385, "official":true, "type":"pitch", "wall_clock":{ "start_time":"2025-03-19T12:28:07+00:00", "end_time":"2025-03-19T12:28:24+00:00" }, "flags":{ "is_ab_over":false, "is_bunt":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":1, "strikes":1, "outs":2, "pitch_count":2 }, "pitcher":{ "pitch_type":"FA", "pitch_speed":92.8, "pitch_zone":13, "pitcher_hand":"R", "hitter_hand":"R", "pitch_count":12, "id":"fe45e33b-f554-4856-af56-1f4f578eaa82", "pitch_x":-105, "pitch_y":-73, "preferred_name":"Kirby", "first_name":"Kirby", "last_name":"Yates", "jersey_number":"38", "full_name":"Kirby Yates" }, "hitter":{ "preferred_name":"Carson", "first_name":"Carson", "last_name":"Kelly", "jersey_number":"15", "id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "full_name":"Carson Kelly" }, "score":{ "home_team_runs":3, "away_team_runs":6 }, "mlb_pitch_data":{ "speed":92.8, "strike_zone_top":3.33, "strike_zone_bottom":1.66, "zone":9, "code":"FF", "description":"Four-Seam Fastball", "coordinates":{ "x":87.96, "y":186.97 } } }, { "status":"official", "id":"1e5f0da5-ea56-4208-b588-bc996c5ea365", "outcome_id":"bB", "created_at":"2025-03-19T12:30:41+00:00", "updated_at":"2025-03-19T12:30:42+00:00", "sequence_number":386, "official":true, "type":"pitch", "wall_clock":{ "start_time":"2025-03-19T12:28:24+00:00", "end_time":"2025-03-19T12:28:46+00:00" }, "flags":{ "is_ab_over":false, "is_bunt":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":2, "strikes":1, "outs":2, "pitch_count":3 }, "pitcher":{ "pitch_type":"SP", "pitch_speed":86.1, "pitch_zone":12, "pitcher_hand":"R", "hitter_hand":"R", "pitch_count":13, "id":"fe45e33b-f554-4856-af56-1f4f578eaa82", "pitch_x":-70, "pitch_y":-221, "preferred_name":"Kirby", "first_name":"Kirby", "last_name":"Yates", "jersey_number":"38", "full_name":"Kirby Yates" }, "hitter":{ "preferred_name":"Carson", "first_name":"Carson", "last_name":"Kelly", "jersey_number":"15", "id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "full_name":"Carson Kelly" }, "score":{ "home_team_runs":3, "away_team_runs":6 }, "mlb_pitch_data":{ "speed":86.1, "strike_zone_top":3.33, "strike_zone_bottom":1.66, "zone":14, "code":"FS", "description":"Splitter", "coordinates":{ "x":98.1, "y":233.36 } } }, { "hit_location":"16", "hit_type":"GB", "status":"official", "id":"5fac3951-6210-43f1-ace7-5ec7a7cf0fe3", "outcome_id":"aROV", "created_at":"2025-03-19T12:30:42+00:00", "updated_at":"2025-04-04T20:33:02+00:00", "sequence_number":387, "official":false, "type":"pitch", "wall_clock":{ "start_time":"2025-03-19T12:28:46+00:00", "end_time":"2025-03-19T12:29:21+00:00" }, "flags":{ "is_ab_over":true, "is_bunt":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":2, "strikes":1, "outs":2, "pitch_count":3 }, "pitcher":{ "pitch_type":"FA", "pitch_speed":93.3, "pitch_zone":5, "pitcher_hand":"R", "hitter_hand":"R", "pitch_count":13, "id":"fe45e33b-f554-4856-af56-1f4f578eaa82", "pitch_x":-11, "pitch_y":-4, "preferred_name":"Kirby", "first_name":"Kirby", "last_name":"Yates", "jersey_number":"38", "full_name":"Kirby Yates" }, "hitter":{ "preferred_name":"Carson", "first_name":"Carson", "last_name":"Kelly", "jersey_number":"15", "id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "full_name":"Carson Kelly" }, "score":{ "home_team_runs":3, "away_team_runs":6 }, "pitching":{ "rov":1 }, "hitting":{ "rov":1 }, "mlb_pitch_data":{ "speed":93.3, "strike_zone_top":3.33, "strike_zone_bottom":1.66, "zone":5, "code":"FF", "description":"Four-Seam Fastball", "coordinates":{ "x":114.01, "y":172.52 } }, "mlb_hit_data":{ "trajectory":"ground_ball", "hardness":"medium", "coordinates":{ "coord_x":79.38, "coord_y":128.49 } }, "runners":[ { "starting_base":0, "ending_base":1, "out":false, "outcome_id":"AD1", "preferred_name":"Carson", "first_name":"Carson", "last_name":"Kelly", "jersey_number":"15", "id":"d421cd0d-43d1-41fa-9ef0-8bf1bb2442aa", "full_name":"Carson Kelly" } ], "errors":[ { "type":"violation", "preferred_name":"Miguel", "first_name":"Miguel", "last_name":"Rojas", "jersey_number":"72", "id":"9fcd5310-c80e-428e-bd9f-048ba1043b4e", "full_name":"Miguel Rojas" } ] } ] } }, ``` ```xml Game Summary Snippet (xml) ``` ```json Game Summary Snippet (json) "statistics":{ "hitting":{ "overall":{ "ab":33, "lob":16, "rbi":3, "abhr":0, "abk":3.3, "bip":23, "babip":0.217, "bbk":0.3, "bbpa":0.081, "iso":0.03, "obp":0.243, "ops":0.425, "seca":0.152, "slg":0.182, "xbh":1, "pitch_count":145, "lob_risp_2out":3, "team_lob":6, "ab_risp":10, "hit_risp":3, "rbi_2out":1, "linedrive":6, "groundball":8, "popup":1, "flyball":8, "ap":37, "avg":".152", "gofo":0.5, "onbase":{ "s":4, "d":1, "t":0, "hr":0, "tb":6, "bb":3, "ibb":0, "hbp":1, "fc":1, "roe":1, "h":5, "ci":0, "rov":0, "cycle":0 }, "runs":{ "total":4 }, "outcome":{ "klook":30, "kswing":11, "ktotal":41, "ball":44, "iball":0, "dirtball":4, "foul":32 }, "outs":{ "po":1, "fo":7, "fidp":0, "lo":4, "lidp":0, "go":6, "gidp":0, "klook":6, "kswing":4, "ktotal":10, "sacfly":0, "sachit":0 }, "steal":{ "caught":0, "stolen":1, "pct":1, "pickoff":0 }, "pitches":{ "count":145, "btotal":49, "ktotal":96 } } }, "pitching":{ "overall":{ "oba":0.172, "lob":6, "era":4, "k9":8.001, "whip":1, "kbb":2, "pitch_count":152, "wp":2, "bk":0, "ip_1":27, "ip_2":9, "bf":35, "gofo":1.833, "babip":0.19, "bf_ip":3.889, "bf_start":15, "gbfb":3.25, "oab":29, "slg":0.276, "obp":0.286, "onbase":{ "s":4, "d":0, "t":0, "hr":1, "tb":8, "bb":4, "ibb":0, "hbp":1, "fc":1, "roe":1, "h":5, "ci":0, "rov":0, "h9":5.004, "hr9":0.999 }, "runs":{ "total":4, "unearned":0, "earned":4, "ir":0, "ira":0, "bqr":0, "bqra":0 }, "outcome":{ "klook":24, "kswing":19, "ktotal":43, "ball":55, "iball":0, "dirtball":5, "foul":26 }, "outs":{ "po":1, "fo":3, "fidp":0, "lo":2, "lidp":0, "go":11, "gidp":0, "klook":2, "kswing":6, "ktotal":8, "sacfly":1, "sachit":0 }, "steal":{ "caught":2, "stolen":1, "pickoff":1 }, "pitches":{ "count":152, "btotal":61, "ktotal":91, "per_ip":16.889, "per_bf":4.343, "per_start":68 }, "in_play":{ "linedrive":4, "groundball":13, "popup":1, "flyball":4 }, "games":{ "svo":2, "qstart":0, "shutout":0, "complete":0, "win":0, "loss":0, "save":0, "hold":1, "blown_save":2 } }, "starters":{ "oba":0.133, "lob":4, "era":0, "k9":6.228, "whip":0.4615, "kbb":0, "pitch_count":68, "wp":0, "bk":0, "ip_1":13, "ip_2":4.1, "bf":15, "gofo":2.333, "babip":0.167, "bf_ip":3.462, "bf_start":15, "gbfb":9, "oab":15, "slg":0.133, "obp":0.133, "onbase":{ "s":2, "d":0, "t":0, "hr":0, "tb":2, "bb":0, "ibb":0, "hbp":0, "fc":1, "roe":1, "h":2, "ci":0, "rov":0, "h9":4.158, "hr9":0 }, "runs":{ "total":0, "unearned":0, "earned":0, "ir":0, "ira":0, "bqr":0, "bqra":0 }, "outcome":{ "klook":11, "kswing":9, "ktotal":20, "ball":22, "iball":0, "dirtball":2, "foul":12 }, "outs":{ "po":0, "fo":1, "fidp":0, "lo":2, "lidp":0, "go":7, "gidp":0, "klook":0, "kswing":3, "ktotal":3, "sacfly":0, "sachit":0 }, "steal":{ "caught":0, "stolen":0, "pickoff":1 }, "pitches":{ "count":68, "btotal":24, "ktotal":44, "per_ip":15.692, "per_bf":4.533, "per_start":68 }, "in_play":{ "linedrive":2, "groundball":9, "popup":0, "flyball":1 }, "games":{ "svo":0, "qstart":0, "shutout":0, "complete":0, "win":0, "loss":0, "save":0, "hold":0, "blown_save":0 } }, ``` ***
### Awards Endpoints

Release Date	Feeds Affected	Benefit
03/19/2025	Awards List Seasonal Awards	We've added two RESTful endpoints to our MLB API: [Awards List](https://developer.sportradar.com/baseball/reference/mlb-awards-list) and [Seasonal Awards](https://developer.sportradar.com/baseball/reference/mlb-seasonal-awards) . With these endpoints, dive into detailed data on awards like MVP, Rookie of the Year, and Manager of the Year for both leagues, including information on players, teams, and coaches. - Awards List - Provides a list of all MLB awards available in the API. - Seasonal Awards - Provides a list of all MLB awards for a given season and season type.

```xml Awards List Snippet (xml) ``` ```json Seasonal Awards Snippet (json) { "league": { "alias": "MLB", "name": "Major League Baseball", "id": "2fa448bc-fc17-4d3d-be03-e60e080fdc26" }, "season": { "id": "6a5c278f-ebce-41f9-b1ba-2160b6af04ce", "year": 2024, "type": "REG" }, "awards": [ { "award": { "name": "Roberto Clemente Award", "description": "This award is given to the player who best exemplifies the game's values of sportsmanship, community involvement, and philanthropy.", "type": "Player", "effective_date": "2024-10-28", "awarded_time_frequency": "annual", "awarded_time_period": "2024", "id": "49dd54ae-739b-4a81-bbe7-ad16ce36b709", "recipients": [ { "level": "winner", "team": { "name": "Royals", "market": "Kansas City", "abbr": "KC", "id": "833a51a9-0d84-410f-bd77-da08c3e5e26e" }, "name": "Salvador Perez", "position": "C", "id": "9baf07d4-b1cb-4494-8c95-600d9e8de1a9" } ] } }, { "award": { "name": "AL Gold Glove", "description": "This award is given to the best defenders at each position in the American League.", "type": "Player", "effective_date": "2024-11-03", "awarded_time_frequency": "annual", "awarded_time_period": "2024", "id": "bb804e20-9d2c-423f-81b3-a5d9ae1edbb7", "recipients": [ { "level": "winner", "team": { "name": "Guardians", "market": "Cleveland", "abbr": "CLE", "id": "80715d0d-0d2a-450f-a970-1b9a3b18c7e7" }, "name": "Steven Kwan", "position": "LF", "id": "a0cad108-d00e-422a-bd43-36601fbe0db4" } ] } }, { "award": { "name": "AL Gold Glove", "description": "This award is given to the best defenders at each position in the American League.", "type": "Player", "effective_date": "2024-11-03", "awarded_time_frequency": "annual", "awarded_time_period": "2024", "id": "bb804e20-9d2c-423f-81b3-a5d9ae1edbb7", "recipients": [ { "level": "winner", "team": { "name": "Astros", "market": "Houston", "abbr": "HOU", "id": "eb21dadd-8f10-4095-8bf3-dfb3b779f107" }, "name": "Alex Bregman", "position": "3B", "id": "7229d580-9405-4d8b-b582-0980dbb2a46a" } ] } }, ``` ***
### Team Wins/Losses in Schedule Endpoints

Release Date	Feeds Affected	Benefit
03/07/2025	Daily Schedule League Schedule	We've added overall team wins and losses to our RESTful [Schedule](https://developer.sportradar.com/baseball/reference/mlb-league-schedule) endpoints. Use these new fields to more easily determine a team's win/loss record prior to and after each game. - `home.win` - Number of losses for the home team at the beginning of a game. Total will update if necessary once the game has completed. - `home.loss` - Number of losses for the home team at the beginning of a game. Total will update if necessary once the game has completed. - `away.win` - Number of losses for the away team at the beginning of a game. Total will update if necessary once the game has completed. - `away.loss` - Number of losses for the away team at the beginning of a game. Total will update if necessary once the game has completed.

```xml League Schedule Snippet (xml) ``` ```json League Schedule Snippet (json) "games": [ { "id": "09f23ca9-221c-485d-a3c4-f5ee7f1d652d", "status": "canceled", "coverage": "full", "game_number": 1, "day_night": "D", "scheduled": "2025-02-24T18:05:00+00:00", "home_team": "2142e1ba-3b40-445c-b8bb-f1f8b1054220", "away_team": "481dfe7e-5dab-46ab-a49f-9dcc2b6e2cfd", "double_header": false, "split_squad": false, "entry_mode": "LDE", "reference": "778913", ---snip--- }, "home": { "name": "Phillies", "market": "Philadelphia", "abbr": "PHI", "id": "2142e1ba-3b40-445c-b8bb-f1f8b1054220", "win": 0, "loss": 2 }, "away": { "name": "Pirates", "market": "Pittsburgh", "abbr": "PIT", "id": "481dfe7e-5dab-46ab-a49f-9dcc2b6e2cfd", "win": 2, "loss": 0 }, "broadcasts": [ { "network": "NBCSP+" } ] }, ``` ***
### Free Agents Endpoint

Release Date	Feeds Affected	Benefit
02/28/2025	Free Agents	We added a [Free Agents](https://developer.sportradar.com/baseball/reference/mlb-free-agents) endpoint, which returns a list of all current free agents in the league. This is available in MLB v8 and MLB v7.

```xml Sample (xml) ``` ```json Sample (json) { "league": { "alias": "MLB", "name": "Major League Baseball", "id": "2fa448bc-fc17-4d3d-be03-e60e080fdc26", "free_agents": [ { "id": "00021b00-7b80-4277-ab4c-ce155308583f", "first_name": "Jarred", "last_name": "Bogany", "preferred_name": "Jarred", "full_name": "Jarred Bogany", "position": "OF", "status": "FA", "mlbam_id": "475648", "height": "75", "weight": "200", "throw_hand": "R", "bat_hand": "R", "updated": "2020-02-27T15:59:31+00:00" }, { "id": "0003f2a3-0428-4a17-8431-bb903cd8252b", "first_name": "Dwayne", "last_name": "Hosey", "preferred_name": "Dwayne", "full_name": "Dwayne Hosey", "status": "FA", "mlbam_id": "116165", "height": "0", "weight": "0", "throw_hand": "R", "bat_hand": "B", "updated": "2020-02-25T18:43:44+00:00" }, { "id": "00069a01-b6d7-48e5-b076-072b97acf3b2", "first_name": "Elias Eduardo", "last_name": "Valdez", "preferred_name": "Elias Eduardo", "full_name": "Elias Eduardo Valdez", "position": "P", "status": "FA", "mlbam_id": "593483", "height": "75", "weight": "165", "throw_hand": "L", "bat_hand": "L", "updated": "2020-02-27T18:01:34+00:00" }, { "id": "000f4e46-32a5-4db8-a5d2-6b7652ac4291", "first_name": "Cristian", "last_name": "Guzman", "preferred_name": "Cristian", "full_name": "Cristian Guzman", "position": "IF", "status": "FA", "mlbam_id": "150217", "height": "72", "weight": "150", "throw_hand": "R", "bat_hand": "B", "updated": "2020-02-07T15:37:17+00:00" }, { "id": "000f5fb3-a2d5-4219-abbb-8f6a231bcb83", "first_name": "Ryan", "last_name": "Khoury", "preferred_name": "Ryan", "full_name": "Ryan Khoury", "position": "IF", "status": "FA", "mlbam_id": "501929", "height": "70", "weight": "180", "throw_hand": "R", "bat_hand": "R", "updated": "2020-02-24T20:27:07+00:00" } ``` ***
### Statcast Event Tracking Metrics

Release Date	Feeds Affected	Benefit
02/21/2025	Event Tracking	Explore an array of new Statcast metrics, including sword swings, swing length, catch probability, and more in our [Event Tracking](https://developer.sportradar.com/baseball/reference/mlb-event-tracking) endpoint. Click [here](https://developer.sportradar.com/baseball/page/mlb-statcast-event-tracking-metrics#newmetrics) for a comprehensive list of the new metrics and their definitions.

```xml Sample (xml) ``` ***
### Mound Visits, Reviews, & Delay Duration

Release Date	Feeds Affected	Benefit
02/10/2025	Game Boxscore Game Extended Summary Game Pitch Metrics Game Play-by-Play Game Summary	We have made a few updates to account for mound visits, reviews, and delays in MLB games. Game endpoints will now feature the below data points. - Game Delay Duration (`game.delay_duration`) -> Duration of a game delay in hours and minutes (ex. `0:18`) - Home/Away Mound Visits Used (`mound_visits.home.used` or `mound_visits.away.used`) -> Number of used mound visits for the home/away team - Home/Away Mound Visits Remaining (`mound_visits.home.remaining` or `mound_visits.away.remaining`) -> Number of remaining mound visits for the home/away team - Home/Away Reviews Used (`reviews.home.used` or `reviews.away.used`) -> Number of used reviews for the home/away team - Home/Away Reviews Remaining (`reviews.home.used` or `reviews.away.used`) -> Number of remaining reviews for the home/away team

```json PBP Snippet (json) { "id":"f6397a7e-5133-4481-b586-41dffca91b0f", "status":"complete", "coverage":"full", "attendance":33650, "duration":"2:42", "delay_duration":"0:01", "game_number":1, "double_header":false, "entry_mode":"STOMP", "neutral_site":false, "scheduled_innings":9, "mlb_id":"775325", "season_id":"f23888ed-6ca7-45bf-99e1-24b7393f540c", "season_type":"PST", "season_year":2024, "day_night":"D", "scheduled":"2024-10-07T20:08:00+00:00", "closed_at":"2025-01-24T18:15:16+00:00", "ps_round":"ALDS", "ps_game":"2", "home_team":"80715d0d-0d2a-450f-a970-1b9a3b18c7e7", "away_team":"575c19b7-4052-41c2-9f0a-1c5813d02f99", "mound_visits":{ "home":{ "used":3, "remaining":1 }, "away":{ "used":1, "remaining":3 } }, "reviews":{ "home":{ "used":0, "remaining":1 }, "away":{ "used":1, "remaining":0 } }, "time_zones":{ "venue":"US/Eastern", "home":"US/Eastern", "away":"US/Eastern" }, "venue":{ "id":"2b0ccd49-4d87-4996-ac4d-27ffc7ee4c16", "name":"Progressive Field", "market":"Cleveland", "capacity":34788, "surface":"grass", "address":"2401 Ontario Street", "city":"Cleveland", "state":"OH", "zip":"44115", "country":"USA", "field_orientation":"N", "stadium_type":"outdoor", "location":{ "lat":"41.4957048", "lng":"-81.6852732" }, "time_zone":"US/Eastern" }, "broadcast":{ }, "broadcasts":[ { "network":"Max", "type":"Internet", "url":null, "channel":null, "locale":"National" }, { "network":"truTV", "type":"TV", "url":null, "channel":"246", "locale":"National" }, { "network":"TBS", "type":"TV", "url":null, "channel":"247", "locale":"National" } ], "scoring":{ "home":{ "name":"Guardians", "market":"Cleveland", "abbr":"CLE", "id":"80715d0d-0d2a-450f-a970-1b9a3b18c7e7", "runs":0, "hits":3, "errors":0, "win":1, "loss":1 }, "away":{ "name":"Tigers", "market":"Detroit", "abbr":"DET", "id":"575c19b7-4052-41c2-9f0a-1c5813d02f99", "runs":3, "hits":9, "errors":0, "win":3, "loss":1 } }, ``` ```xml PBP Snippet (xml) ``` ***
### Playoff Seed Numbers

Release Date	Feeds Affected	Benefit
02/07/2025	Daily Schedule League Schedule Series Schedule Series Statistics Series Summary	We have added playoff seed numbers for teams in relevant Schedule and Series endpoints. You may now easily track a team's seed during a game or series.

```json Series Schedule Snippet (json) { "id": "0b022fc1-8155-4f63-b608-513059e4c200", "status": "closed", "coverage": "full", "game_number": 1, "day_night": "D", "scheduled": "2024-10-09T19:08:00+00:00", "home_team": "575c19b7-4052-41c2-9f0a-1c5813d02f99", "away_team": "80715d0d-0d2a-450f-a970-1b9a3b18c7e7", "ps_round": "ALDS", "ps_game": "3", "attendance": 44885, "duration": "2:43", "double_header": false, "entry_mode": "STOMP", "reference": "775328", "venue": { "name": "Comerica Park", "market": "Detroit", "capacity": 41083, "surface": "grass", "address": "2100 Woodward Avenue", "city": "Detroit", "state": "MI", "zip": "48226", "country": "USA", "id": "ef9a5eef-06c6-4963-ac70-7fd02c8c8d42", "field_orientation": "SE", "stadium_type": "outdoor", "time_zone": "US/Eastern", "location": { "lat": "42.3391886", "lng": "-83.04947829999999" } }, "broadcasts": [ { "network": "TBS", "type": "TV", "locale": "National", "channel": "247" }, { "network": "Max", "type": "Internet", "locale": "National" }, { "network": "truTV", "type": "TV", "locale": "National", "channel": "246" } ], "home": { "name": "Tigers", "market": "Detroit", "abbr": "DET", "id": "575c19b7-4052-41c2-9f0a-1c5813d02f99", "seed": 6 }, "away": { "name": "Guardians", "market": "Cleveland", "abbr": "CLE", "id": "80715d0d-0d2a-450f-a970-1b9a3b18c7e7", "seed": 2 } }, ``` ```xml Series Schedule Snippet (xml) ``` ***
### Officials Endpoint

Release Date	Feeds Affected	Benefit
02/03/2025	Officials	We have added an [Officials](https://developer.sportradar.com/baseball/reference/mlb-officials) RESTful endpoint. Request this to get a complete list of all umpires in the league with their unique IDs and officiating tenures.

```json Officials Snippet (json) { "league": { "alias": "MLB", "name": "Major League Baseball", "id": "2fa448bc-fc17-4d3d-be03-e60e080fdc26", "officials": [ { "experience": "24", "first_name": "Jerry", "full_name": "Jerry Lane", "last_name": "Lane (DUP)", "id": "0357636a-7ac6-4c7d-a9d6-f08cea369d7d" }, { "experience": "9", "first_name": "Will", "full_name": "Will Little", "last_name": "Little", "id": "0d38d676-118b-4488-8353-7b4181104997" }, { "experience": "12", "first_name": "Vic", "full_name": "Vic Carapazza", "last_name": "Carapazza", "id": "0d57e1c7-e3dc-4d12-83e7-a2fcb80a0aeb" }, { "experience": "22", "first_name": "Greg", "full_name": "Greg Gibson", "last_name": "Gibson", "id": "163280b5-dcf4-4fed-a0b1-1611eec98758" }, { "experience": "34", "first_name": "Jerry", "full_name": "Jerry Layne", "last_name": "Layne", "id": "1d5d2733-d7c3-4ab2-8fca-6456c83926fe" }, { "experience": "9", "first_name": "Quinn", "full_name": "Quinn Wolcott", "last_name": "Wolcott", "id": "1f751c16-bec1-446a-8c34-89bf0ffdabb9" }, { "experience": "20", "first_name": "Mike", "full_name": "Mike Everitt", "last_name": "Everitt", "id": "23014392-971f-4400-a580-a9b7def8e5c0" }, { "experience": "16", "first_name": "Paul", "full_name": "Paul Schrieber", "last_name": "Schrieber", "id": "245a7a9c-fc69-459e-acc5-77b7092f02f7" }, { "experience": "30", "first_name": "Angel", "full_name": "Angel Hernandez", "last_name": "Hernandez", "id": "25544277-69b0-4c6c-b8ad-b363db64e83a" }, ``` ```xml Officials Snippet (xml) ``` ***
### Salary, Rookie Year, & HOF Year

Release Date	Feeds Affected	Benefit
01/31/2025	Player Profile Team Profile	We have added three new data points for MLB players: salary, rookie year, and Hall of Fame year. Use these fields to build in-depth player profiles. - `salary` - View annual base salary data for active roster players approximately a month before the season begins. - `rookie_year` - Discover each player’s rookie season dating back to 2000. - `hof_year` - Identify Hall of Fame inductees directly within our API.

```json Team Profile Snippet (json) "players": [ { "id": "51c5b523-77b9-4e09-83be-8de6204235e5", "status": "A", "position": "C", "primary_position": "C", "first_name": "Jair", "last_name": "Camargo", "preferred_name": "Jair", "jersey_number": "85", "full_name": "Jair Camargo", "height": "70", "weight": "230", "throw_hand": "R", "bat_hand": "R", "birthdate": "1999-07-01", "birthcountry": "COL", "birthcity": "Barranquilla", "pro_debut": "2024-04-16", "updated": "2025-01-29T02:28:49+00:00", "salary": 800000, "rookie_year": 2024, "reference": "665856", "active": true }, { "id": "0dd2993e-2e61-450f-933a-00d8db8e186c", "status": "A", "position": "C", "primary_position": "C", "first_name": "Diego", "last_name": "Cartaya", "preferred_name": "Diego", "full_name": "Diego Cartaya", "height": "75", "weight": "219", "throw_hand": "R", "bat_hand": "R", "birthdate": "2001-09-07", "birthcountry": "VEN", "birthcity": "Maracay", "updated": "2025-01-29T02:29:09+00:00", "salary": 800000, "reference": "682616", "active": true }, { "id": "005c0339-91b9-4b00-a373-105e761382eb", "status": "A", "position": "C", "primary_position": "C", "first_name": "Ryan", "last_name": "Jeffers", "preferred_name": "Ryan", "jersey_number": "27", "full_name": "Ryan Jeffers", "height": "76", "weight": "235", "throw_hand": "R", "bat_hand": "R", "college": "UNC Wilmington", "high_school": "Sanderson (NC)", "birthdate": "1997-06-03", "birthstate": "NC", "birthcountry": "USA", "birthcity": "Raleigh", "pro_debut": "2020-08-20", "updated": "2025-01-29T02:31:40+00:00", "salary": 4550000, "rookie_year": 2021, "reference": "680777", "active": true }, { "id": "0d7a27a9-f41c-4fce-930e-113aa4cf4c52", "status": "A", "position": "C", "primary_position": "C", "first_name": "Christian", "last_name": "Vázquez", "preferred_name": "Christian", "jersey_number": "8", "full_name": "Christian Vázquez", "height": "69", "weight": "205", "throw_hand": "R", "bat_hand": "R", "high_school": "Puerto Rico Baseball Academy (PRI)", "birthdate": "1990-08-21", "birthcountry": "PRI", "birthcity": "Bayamon", "pro_debut": "2014-07-09", "updated": "2025-01-29T02:35:43+00:00", "salary": 10000000, "rookie_year": 2014, "reference": "543877", "active": true }, { "id": "3c273dc1-e828-48d3-bf04-1f26cbee97ac", "status": "A", "position": "IF", "primary_position": "2B", "first_name": "Willi", "last_name": "Castro", "preferred_name": "Willi", "jersey_number": "50", "full_name": "Willi Castro", "height": "73", "weight": "206", "throw_hand": "R", "bat_hand": "B", "birthdate": "1997-04-24", "birthcountry": "PRI", "birthcity": "Rio Piedras", "pro_debut": "2019-08-24", "updated": "2025-01-29T02:29:41+00:00", "salary": 6400000, "rookie_year": 2020, "reference": "650489", "active": true }, { "id": "3259a7ad-0490-4912-bd86-d06bf3ac91e0", "status": "A", "position": "IF", "primary_position": "SS", "first_name": "Carlos", "last_name": "Correa", "preferred_name": "Carlos", "jersey_number": "4", "full_name": "Carlos Correa", "height": "76", "weight": "220", "throw_hand": "R", "bat_hand": "R", "high_school": "Puerto Rico Baseball Academy (PRI)", "birthdate": "1994-09-22", "birthcountry": "PRI", "birthcity": "Santa Isabel", "pro_debut": "2015-06-08", "updated": "2025-01-29T02:30:01+00:00", "salary": 37333333, "rookie_year": 2015, "reference": "621043", "active": true }, { "id": "1bbed35d-2b20-488a-b7ac-95b8ca896ad6", "status": "A", "position": "IF", "primary_position": "2B", "first_name": "Michael", "last_name": "Gasper", "preferred_name": "Mickey", "full_name": "Mickey Gasper", "height": "70", "weight": "205", "throw_hand": "R", "bat_hand": "B", "college": "Bryant", "high_school": "Merrimack (NH)", "birthdate": "1995-10-11", "birthstate": "NH", "birthcountry": "USA", "birthcity": "Merrimack", "pro_debut": "2024-08-12", "updated": "2025-01-29T02:30:36+00:00", "salary": 800000, "rookie_year": 2024, "reference": "681508", "active": true }, { "id": "16609d33-22a9-43ad-aeae-b8f9f606e5aa", "status": "A", "position": "IF", "primary_position": "2B", "first_name": "Michael", "last_name": "Helman", "preferred_name": "Michael", "jersey_number": "92", "full_name": "Michael Helman", "height": "72", "weight": "195", "throw_hand": "R", "bat_hand": "R", "college": "Texas A&M", "high_school": "Pius X (NE)", "birthdate": "1996-05-23", "birthstate": "NE", "birthcountry": "USA", "birthcity": "Lincoln", "pro_debut": "2024-09-03", "updated": "2025-01-30T13:58:00+00:00", "salary": 800000, "rookie_year": 2024, "reference": "680737", "active": true }, ``` ```xml Team Profile Snippet (xml) ``` ```json Player Profile Snippet (HOF) { "player": { "id": "31d992e8-1016-484a-b7c3-2b5851442cc5", "status": "RET", "position": "IF", "primary_position": "1B", "first_name": "Joseph", "last_name": "Mauer", "preferred_name": "Joe", "full_name": "Joe Mauer", "height": "77", "weight": "225", "throw_hand": "R", "bat_hand": "L", "high_school": "Cretin-Derham Hall (MN)", "birthdate": "1983-04-19", "birthstate": "MN", "birthcountry": "USA", "birthcity": "St. Paul", "pro_debut": "2004-04-05", "updated": "2024-12-18T19:30:59+00:00", "rookie_year": 2004, "reference": "408045", "hof_year": 2024, "draft": { "team_id": "aa34e0ed-f342-4ec6-b774-c79b47b60e2d", "year": 2001, "round": 1, "pick": 1 }, ``` ***
### Score on a Play Level

Release Date	Feeds Affected	Benefit
01/30/2025	Game Play-by-Play Push Events	Beginning in 2025 Spring Training games, receive the game score for every at bat and event in the Game Play-by-Play endpoint. Attributes (available under `at_bat` and `events`): - `away_team_runs` - `home_team_runs`

```json PBP Snippet (json) "at_bat":{ "sequence_number":2, "hitter_id":"205f199d-bf37-49e8-9448-6201f8a33cef", "hitter_hand":"R", "pitcher_id":"c3e45b7f-c631-472c-ac33-5377df84302d", "pitcher_hand":"L", "id":"94846d35-d9e5-4030-a2b4-13850161d1bf", "sequence":1728331732956, "description":"Justyn-Henry Malloy flies out to center field to Lane Thomas.", "score":{ "home_team_runs":0, "away_team_runs":0 }, "hitter":{ "id":"205f199d-bf37-49e8-9448-6201f8a33cef", "first_name":"Justyn-Henry", "last_name":"Malloy", "preferred_name":"Justyn-Henry", "full_name":"Justyn-Henry Malloy", "jersey_number":"44", "status":"A" }, "pitcher":{ "id":"c3e45b7f-c631-472c-ac33-5377df84302d", "first_name":"Matthew", "last_name":"Boyd", "preferred_name":"Matthew", "full_name":"Matthew Boyd", "jersey_number":"16", "status":"A" }, "events":[ { "type":"pitch", "sequence_number":3, "official":true, "sequence":1728331733006, "reference":"da98b0bd-60e2-4ef2-8aaa-f6d6340dcf1f", "score":{ "home_team_runs":0, "away_team_runs":0 }, "id":"8cb186a8-3bce-48f2-a7b5-dbdb438ca590", "outcome_id":"kKS", "status":"official", "created_at":"2024-10-07T20:09:28+00:00", "updated_at":"2024-10-07T20:10:08+00:00", "wall_clock":{ "start_time":"2024-10-07T20:09:30+00:00", "end_time":"2024-10-07T20:09:37+00:00" }, "flags":{ "is_ab":false, "is_ab_over":false, "is_bunt":false, "is_bunt_shown":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_on_base":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":0, "strikes":1, "outs":0, "pitch_count":1 }, "pitcher":{ "pitch_type":"FA", "pitch_speed":92.5, "pitch_zone":1, "pitch_x":-47, "pitch_y":82, "id":"c3e45b7f-c631-472c-ac33-5377df84302d", "pitcher_hand":"L", "hitter_hand":"R", "pitch_count":1, "first_name":"Matthew", "last_name":"Boyd", "preferred_name":"Matthew", "full_name":"Matthew Boyd", "jersey_number":"16", "status":"A" }, "hitter":{ "id":"205f199d-bf37-49e8-9448-6201f8a33cef", "first_name":"Justyn-Henry", "last_name":"Malloy", "preferred_name":"Justyn-Henry", "full_name":"Justyn-Henry Malloy", "jersey_number":"44", "status":"A" }, "mlb_pitch_data":{ "end_speed":84.6, "extension":6.188728022077536, "breaks":{ "spin_rate":2386, "break_horizontal":-9.7, "break_angle":15.6, "break_vertical":-17.5, "break_vertical_induced":14.5, "spin_direction":133 }, "start_speed":92.5, "zone":3, "plate_time":0.4068426430725882, "coordinates":{ "pfx_x":6.221744028771722, "p_x":0.3318753994839694, "p_z":3.25877341464399, "pfx_z":8.186717400528035, "v_y0":-134.57683083454265, "v_z0":-2.5371996201784075, "v_x0":-7.141122419616458, "z0":5.426453898595921, "y0":50.002241998014966, "a_x":11.424542411046252, "a_y":28.91877208535717, "x":104.35, "x0":2.210121088071853, "a_z":-17.140404890928753, "y":150.79 }, "strike_zone_top":3.46, "strike_zone_bottom":1.68, "code":"FF", "description":"Four-Seam Fastball" } }, { "type":"pitch", "sequence_number":4, "official":true, "sequence":1728331781368, "reference":"eff566eb-c6a0-48fc-8100-004c567a9d13", "score":{ "home_team_runs":0, "away_team_runs":0 }, "id":"1a9c85e3-1c0c-4816-98c8-f221f2c4bc78", "outcome_id":"kF", "status":"official", "created_at":"2024-10-07T20:09:41+00:00", "updated_at":"2024-10-07T20:10:27+00:00", "wall_clock":{ "start_time":"2024-10-07T20:09:37+00:00", "end_time":"2024-10-07T20:09:57+00:00" }, "flags":{ "is_ab":false, "is_ab_over":false, "is_bunt":false, "is_bunt_shown":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_on_base":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":0, "strikes":2, "outs":0, "pitch_count":2 }, "pitcher":{ "pitch_type":"FA", "pitch_speed":92.5, "pitch_zone":3, "pitch_x":47, "pitch_y":82, "id":"c3e45b7f-c631-472c-ac33-5377df84302d", "pitcher_hand":"L", "hitter_hand":"R", "pitch_count":2, "first_name":"Matthew", "last_name":"Boyd", "preferred_name":"Matthew", "full_name":"Matthew Boyd", "jersey_number":"16", "status":"A" }, "hitter":{ "id":"205f199d-bf37-49e8-9448-6201f8a33cef", "first_name":"Justyn-Henry", "last_name":"Malloy", "preferred_name":"Justyn-Henry", "full_name":"Justyn-Henry Malloy", "jersey_number":"44", "status":"A" }, "mlb_pitch_data":{ "end_speed":84.4, "extension":6.2201309612811695, "breaks":{ "spin_rate":2466, "break_horizontal":-10.7, "break_angle":22.8, "break_vertical":-17.4, "break_vertical_induced":14.6, "spin_direction":128 }, "start_speed":92.5, "zone":1, "plate_time":0.40752204189324237, "coordinates":{ "pfx_x":6.978657153132929, "p_x":-0.3190869662643606, "p_z":3.285628516795675, "pfx_z":8.288410045075706, "v_y0":-134.43347493218565, "v_z0":-2.476019046911043, "v_x0":-8.973296334866335, "z0":5.426692678836634, "y0":50.00010170301573, "a_x":12.764811156472835, "a_y":29.293965175169486, "x":129.16, "x0":2.1561919356037267, "a_z":-17.00915426823185, "y":150.07 }, "strike_zone_top":3.46, "strike_zone_bottom":1.68, "code":"FF", "description":"Four-Seam Fastball" } }, { "type":"pitch", "sequence_number":5, "official":true, "sequence":1728331808320, "reference":"9dcd5945-955e-490b-86cf-40f18f6bb774", "score":{ "home_team_runs":0, "away_team_runs":0 }, "id":"54826902-d729-457a-ad6b-56dbcd2dd98b", "hit_location":"13", "hit_type":"FB", "outcome_id":"oFO", "status":"official", "created_at":"2024-10-07T20:10:08+00:00", "updated_at":"2024-10-07T20:10:36+00:00", "wall_clock":{ "start_time":"2024-10-07T20:09:57+00:00", "end_time":"2024-10-07T20:10:12+00:00" }, "flags":{ "is_ab":true, "is_ab_over":true, "is_bunt":false, "is_bunt_shown":false, "is_hit":false, "is_wild_pitch":false, "is_passed_ball":false, "is_on_base":false, "is_double_play":false, "is_triple_play":false }, "count":{ "balls":0, "strikes":2, "outs":1, "pitch_count":3 }, "pitcher":{ "pitch_type":"CH", "pitch_speed":81.2, "pitch_zone":4, "pitch_x":-64, "pitch_y":-30, "id":"c3e45b7f-c631-472c-ac33-5377df84302d", "pitcher_hand":"L", "hitter_hand":"R", "pitch_count":3, "first_name":"Matthew", "last_name":"Boyd", "preferred_name":"Matthew", "full_name":"Matthew Boyd", "jersey_number":"16", "status":"A" }, "hitter":{ "id":"205f199d-bf37-49e8-9448-6201f8a33cef", "first_name":"Justyn-Henry", "last_name":"Malloy", "preferred_name":"Justyn-Henry", "full_name":"Justyn-Henry Malloy", "jersey_number":"44", "status":"A" }, "mlb_pitch_data":{ "end_speed":74.3, "extension":6.305102358215967, "breaks":{ "spin_rate":2009, "break_horizontal":-15.8, "break_angle":8.4, "break_vertical":-34.8, "break_vertical_induced":6.8, "spin_direction":120 }, "start_speed":81.2, "zone":6, "plate_time":0.46454644682130164, "coordinates":{ "pfx_x":9.731616131875914, "p_x":0.4551940512152308, "p_z":2.3193289931899663, "pfx_z":3.876464142651928, "v_y0":-117.98769333137939, "v_z0":-1.6422142609015347, "v_x0":-7.228512038997766, "z0":5.490661838226673, "y0":50.001212961901, "a_x":13.693870487922805, "a_y":22.841254480423736, "x":99.65, "x0":2.2970417169886894, "a_z":-26.71648792715716, "y":176.16 }, "strike_zone_top":3.46, "strike_zone_bottom":1.68, "code":"CH", "description":"Changeup" }, "mlb_hit_data":{ "hardness":"medium", "coordinates":{ "coord_x":104.55, "coord_y":88.62 }, "launch_speed":84.9, "location":"8", "total_distance":282, "trajectory":"fly_ball", "launch_angle":39 }, "fielders":[ { "id":"182d02a7-c606-4a85-a635-89dd1afdac6f", "type":"putout", "sequence":1, "first_name":"Lane", "last_name":"Thomas", "preferred_name":"Lane", "full_name":"Lane Thomas", "jersey_number":"8", "status":"A" } ] } ] } }, ``` ```xml PBP Snippet (xml) Mookie Betts grounds out to shortstop. Andrew Benintendi to second. Dustin Pedroia out at third. Andrew Benintendi to second. Dustin Pedroia out at third. ``` ***
### Multiple Broadcasts Per Game

Release Date	Feeds Affected	Benefit
01/28/2025	Daily Boxscore Daily Schedule Daily Summary Game Boxscore Game Extended Summary Game Pitch Metrics Game Play-by-Play Game Summary League Schedule Series Schedule	We've added support for multiple broadcasts for each game. New in MLB v8 is a `broadcasts` node (`broadcast` in previous versions) which includes home team, away team, and national broadcast info for all games, when applicable. See below for sample data.

```xml Schedule Snippet (xml) ``` ```json Schedule Snippet (json) { "id": "4d3677f8-c02a-4d35-977d-27cb0a9d92a6", "status": "closed", "coverage": "full", "game_number": 1, "day_night": "N", "scheduled": "2024-04-03T01:40:00+00:00", "home_team": "25507be1-6a68-4267-bd82-e097d94b359b", "away_team": "a09ec676-f887-43dc-bbb3-cf4bbaee9a18", "attendance": 39863, "duration": "2:27", "double_header": false, "entry_mode": "STOMP", "reference": "747220", "venue": { "name": "Chase Field", "market": "Arizona", "capacity": 48359, "surface": "turf", "address": "401 East Jefferson Street", "city": "Phoenix", "state": "AZ", "zip": "85004", "country": "USA", "id": "bf05de0d-7ced-4a19-8e17-2bbd985f8a92", "field_orientation": "N", "stadium_type": "retractable", "time_zone": "US/Arizona", "location": { "lat": "33.445302", "lng": "-112.066687" } }, "home": { "name": "Diamondbacks", "market": "Arizona", "abbr": "AZ", "id": "25507be1-6a68-4267-bd82-e097d94b359b", "win": 4, "loss": 2 }, "away": { "name": "Yankees", "market": "New York", "abbr": "NYY", "id": "a09ec676-f887-43dc-bbb3-cf4bbaee9a18", "win": 5, "loss": 1 }, "broadcasts": [ { "network": "ARID", "type": "Internet", "locale": "Home" }, { "network": "YES", "type": "TV", "locale": "Away", "channel": "631" } ] }, ``` ***
### MLB v8 API Release | Release Date | Benefit | | :----------- | :---------------- | | 01/28/2025 | Release of MLB v8 | *** ### Pitch Outcomes

Release Date	Feeds Affected	Benefit
01/22/2025	Event Tracking Game Extended Summary Game Play-by-Play Push Events	We've added five pitch `outcome_id` values to account for new MLB rules violations. See below for the new values and their definitions. - `bABP` - Ball - Automatic (Pitch Timer Violation - Pitcher) - `bABC` - Ball - Automatic (Pitch Timer Violation - Catcher) - `bABS` - Ball - Automatic (Shift Violation) - `kAKP` - Strike - Automatic (Pitch Timer Violation) - `kAKB` - Strike - Automatic (Batter Timeout Violation)

```xml Play-by-Play Snippet ``` ```json Play-by-Play Snippet 2 "events": [ { "status": "official", "id": "69969a8c-5926-4483-a04c-d5e627fe83ce", "outcome_id": "bABP", "created_at": "2023-09-20T18:12:09+00:00", "updated_at": "2023-09-20T18:14:42+00:00", "sequence_number": 3, "official": true, "type": "pitch", "wall_clock": { "start_time": "2023-09-20T18:11:54+00:00", "end_time": "2023-09-20T18:12:11+00:00" } ``` ***
### Expanded Spring Training Coverage | Release Date | Feeds Affected | Benefit | | :----------- | :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 02/20/2025 | All **Game** endpoints | The 2025 MLB season will have full pitch-by-pitch Spring Training data for 18 stadiums and 24 MLB teams. See [this FAQ](https://developer.sportradar.com/baseball/reference/mlb-faq#what-spring-training-games-will-have-full-pitch-by-pitch-data) for more details. | ***
## 2024 ### New On-Demand Simulations | Release Date | Benefit | | :----------- | :-------------------------------------------------------------------------------------------- | | 09/09/2024 |

Start your session on your schedule – no more waiting for simulated games to start at a predefined time.
Continually call the endpoint for updates as one would during a live game.

For the Push feeds, simply subscribe to the recording and watch the data come through like it would during a live game.

No API Key is needed to use the simulations.

Please note that [Legacy Simulations]() will be retired in early November.

For more details, see our [Simulations]() page including code snippets for how to set up your calls. | ***