Find all updates to the MLB v8 API and its documentation
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. |
"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
},
<players>
<player 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"/>
<player 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"/>
<player 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"/>
<player 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"/>
<player 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"/>
<player 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"/>
<player 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"/>
<player 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"/>
<player id="fcb6b23a-cace-4dc1-bc05-e12378183fbc" status="A" position="IF" primary_position="2B" first_name="Edouard" last_name="Julien" preferred_name="Edouard" jersey_number="47" full_name="Edouard Julien" height="72" weight="195" throw_hand="R" bat_hand="L" college="Auburn" high_school="Cardinal Roy (CAN)" birthdate="1999-04-30" birthstate="QC" birthcountry="CAN" birthcity="Quebec City" pro_debut="2023-04-12" updated="2025-01-29T02:31:46+00:00" salary="800000" rookie_year="2023" reference="666397" active="true"/>
{
"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 |
"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"
}
]
}
]
}
},
<at_bat hitter_id="084d2514-9ffb-414e-ae16-3bc690aaad51" id="fdff820f-9c93-4d80-a3d7-577a474a8b56" hitter_hand="R" pitcher_id="83417a46-4c33-4026-8113-aad285d27346" pitcher_hand="L">
<hitter preferred_name="Dustin" first_name="Dustin" last_name="Pedroia" jersey_number="12" id="40085c05-fa06-4eec-9f41-f0245980f6a0"/>
<pitcher preferred_name="Chad" first_name="Chadwick" last_name="Bell" jersey_number="64" id="2642c4fd-3301-415f-af20-10eee169c53a"/>
<description>Mookie Betts grounds out to shortstop. Andrew Benintendi to second. Dustin Pedroia out at third.</description>
<score home_team_runs="1" away_team_runs="1"/>
<pitch hit_location="22" hit_type="GB" status="official" id="48607eff-4614-45cf-8373-d811b6acf6b5" outcome_id="oGO" created_at="2017-04-10T20:18:57+00:00" updated_at="2017-04-19T14:43:40+00:00">
<flags is_ab_over="true" is_bunt="false" is_hit="false" is_wild_pitch="false" is_passed_ball="false" is_double_play="true" is_triple_play="false"/>
<count balls="0" strikes="0" outs="2" pitch_count="1"/>
<pitcher pitch_type="CT" pitch_speed="87.0" pitch_zone="4" pitcher_hand="L" hitter_hand="R" pitch_count="3" id="83417a46-4c33-4026-8113-aad285d27346" pitch_x="-52" pitch_y="-30" preferred_name="Masahiro" first_name="Masahiro" last_name="Tanaka" jersey_number="19"/>
<hitter preferred_name="Miguel" first_name="Jose" last_name="Cabrera" jersey_number="24" id="0fad748a-3ed8-4787-97db-845155c8e7ce"/>
<score home_team_runs="1" away_team_runs="1"/>
<fielders>
<putout preferred_name="Miguel" first_name="Jose" last_name="Cabrera" jersey_number="24" id="0fad748a-3ed8-4787-97db-845155c8e7ce" sequence="2"/>
<assist preferred_name="Ian" first_name="Ian" last_name="Kinsler" jersey_number="3" id="8189ef68-447c-4573-94d5-8d690abbcfbf" sequence="1"/>
</fielders>
<runners>
<runner outcome_id="AD2" starting_base="1" ending_base="2" out="false" preferred_name="Andrew" first_name="Andrew" last_name="Benintendi" jersey_number="16" id="0e5244cd-9226-4ee1-bb63-d022a9240ca0">
<description>Andrew Benintendi to second.</description>
</runner>
<runner outcome_id="FO3" starting_base="2" ending_base="0" out="true" preferred_name="Dustin" first_name="Dustin" last_name="Pedroia" jersey_number="15" id="40085c05-fa06-4eec-9f41-f0245980f6a0">
<description>Dustin Pedroia out at third.</description>
<fielders>
<putout preferred_name="Nick" first_name="Nicholas" last_name="Castellanos" jersey_number="9" id="169ed0b1-e34b-4f4b-925b-f3288f24a5e7" sequence="1"/>
</fielders>
</runner>
</runners>
</pitch>
</at_bat>
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. |
<game 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"/>
</venue>
<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>
<broadcast network="ARID" type="Internet" locale="Home"/>
<broadcast network="YES" type="TV" locale="Away" channel="631"/>
</broadcasts>
</game>
{
"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) |
<pitch status="official" id="1f3f6dbf-2313-4863-b94a-2053e4e3ee3d" outcome_id="bABP"
created_at="2023-09-20T19:01:20+00:00" updated_at="2023-09-20T19:01:46+00:00"
sequence_number="129" official="true">
"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 for more details. |
New On-Demand Simulations
| Release Date | Benefit |
|---|---|
| 09/09/2024 | We’re happy to announce expanded on-demand support for REST and push Simulations . This offering allows you to replay select games at your convenience. How it works: Request a list of available recordings by league. For a normal GET game feed:
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. |