MLB API - Score on a Play Level
January 30th, 2025
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_runshome_team_runs
☑️ Sample Requests:
Game Play-by-Play - https://api.sportradar.com/mlb/trial/v8/en/games/{game_id}/pbp.xml?api_key=[API_KEY]
🔢 Versions
🔁 Endpoints Affected
Game Play-by-Play, Push Events
⚙️ Return Samples
"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>