Find all updates to the MLB v8 API and its documentation
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. |
<player 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"/>
</overall>
<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"/>
</starters>
</pitching>
<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"/>
</overall>
<positions>
<position 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"/>
</position>
</positions>
</fielding>
</statistics>
</player>
{
"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 interferencerov - Reached on violationIn the Game 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. |
<at_bat hitter_id="6c196cb7-4607-47f7-a00e-855db3728c03" id="64e6d222-2a42-4708-a1b2-971262006e32" hitter_hand="R" pitcher_id="1af59804-5b77-4d6f-98f7-23e97a400a1b" pitcher_hand="R" sequence_number="107">
<hitter preferred_name="Jon" first_name="Jonathon" last_name="Berti" jersey_number="5" id="6c196cb7-4607-47f7-a00e-855db3728c03" full_name="Jon Berti"/>
<pitcher preferred_name="Roki" first_name="Roki" last_name="Sasaki" jersey_number="11" id="1af59804-5b77-4d6f-98f7-23e97a400a1b" full_name="Roki Sasaki"/>
<description>Jon Berti reaches on catcher interference.</description>
<score home_team_runs="0" away_team_runs="3"/>
<pitch status="official" id="2269eac3-c3b4-4d4e-a456-3d28bf66ac57" outcome_id="aCI" created_at="2025-03-19T10:48:09+00:00" updated_at="2025-04-04T20:08:12+00:00" sequence_number="108" official="false">
<wall_clock start_time="2025-03-19T10:48:01+00:00" end_time="2025-03-19T10:48:14+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="0" strikes="0" outs="1" pitch_count="1"/>
<pitcher pitch_type="FA" pitch_speed="97.1" pitch_zone="5" pitcher_hand="R" hitter_hand="R" pitch_count="31" id="1af59804-5b77-4d6f-98f7-23e97a400a1b" pitch_x="-17" pitch_y="-26" preferred_name="Roki" first_name="Roki" last_name="Sasaki" jersey_number="11" full_name="Roki Sasaki"/>
<hitter preferred_name="Jon" first_name="Jonathon" last_name="Berti" jersey_number="5" id="6c196cb7-4607-47f7-a00e-855db3728c03" full_name="Jon Berti"/>
<score home_team_runs="0" away_team_runs="3"/>
<pitching ci="1"/>
<hitting ci="1"/>
<mlb_pitch_data speed="97.1" strike_zone_top="3.42" strike_zone_bottom="1.59" zone="5" code="FF" description="Four-Seam Fastball">
<coordinates x="111.75" y="177"/>
</mlb_pitch_data>
<mlb_hit_data trajectory="ground_ball" hardness="soft">
<coordinates coord_x="116.02" coord_y="185.55"/>
</mlb_hit_data>
<runners>
<runner starting_base="0" ending_base="1" out="false" outcome_id="AD1" preferred_name="Jon" first_name="Jonathon" last_name="Berti" jersey_number="5" id="6c196cb7-4607-47f7-a00e-855db3728c03" full_name="Jon Berti"/>
</runners>
</pitch>
</at_bat>
{
"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"
}
]
}
]
}
},
<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.0" pickoff="0"/>
<pitches count="145" btotal="49" ktotal="96"/>
</overall>
</hitting>
<pitching>
<overall oba="0.172" lob="6" era="4.0" k9="8.001" whip="1.0" kbb="2.0" pitch_count="152" wp="2" bk="0" ip_1="27" ip_2="9.0" bf="35" gofo="1.833" babip="0.19" bf_ip="3.889" bf_start="15.0" 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.0"/>
<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"/>
</overall>
<starters oba="0.133" lob="4" era="0.0" k9="6.228" whip="0.4615" kbb="0.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.0" gbfb="9.0" 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.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.0"/>
<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"/>
</starters>
"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 and 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. |
<league xmlns="http://feed.elasticstats.com/schema/baseball/v8/league/awards.xsd" alias="MLB" name="Major League Baseball" id="2fa448bc-fc17-4d3d-be03-e60e080fdc26">
<awards id="370965fa-a7f5-42bb-b1d8-0b5cf324739d" name="AL Comeback Player of the Year" description="This award is given to the American League player who is judged to have re-emerged on the baseball field during a given season." type="Player"/>
<awards id="333cb26f-3337-42b5-8d39-90682d43f9d2" name="AL Cy Young" description="This award is given to the best pitcher in the American League." type="Player"/>
<awards id="bb804e20-9d2c-423f-81b3-a5d9ae1edbb7" name="AL Gold Glove" description="This award is given to the best defenders at each position in the American League." type="Player"/>
<awards id="036a9023-589f-4dbc-8041-3b9e7ee546f0" name="AL Hank Aaron Award" description="This award is given to the best overall offensive performer in the American League." type="Player"/>
<awards id="333f06a1-c8f2-4b28-ae38-1b33c90569c0" name="AL Manager of the Year" description="This award is given to the best manager in the American League." type="Coach"/>
{
"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 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. |
<game 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">
<venue name="BayCare Ballpark" capacity="8500" surface="grass" address="601 Old Coachman Road" city="Clearwater" state="FL" zip="33765" country="USA" id="7f5ccc24-6f45-4c0f-8a20-378f8bbd3ba5" field_orientation="NE" stadium_type="outdoor" time_zone="US/Eastern">
<location lat="27.971580" lng="-82.733910"/>
</venue>
<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>
<broadcast network="NBCSP+"/>
</broadcasts>
</game>
"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 endpoint, which returns a list of all current free agents in the league. This is available in MLB v8 and MLB v7. |
<league xmlns="http://feed.elasticstats.com/schema/baseball/v8/free_agents.xsd" alias="MLB" name="Major League Baseball" id="2fa448bc-fc17-4d3d-be03-e60e080fdc26">
<free_agent 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"/>
<free_agent 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"/>
<free_agent 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"/>
<free_agent 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"/>
<free_agent 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"/>
{
"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 endpoint. Click here for a comprehensive list of the new metrics and their definitions. |
<player preferred_name="Eddie" first_name="Eddie" last_name="Rosario" id="4be357dd-add5-4613-937d-6b9a0831d9ee" full_name="Eddie Rosario">
<metrics>
<metric group="Batting" name="Exit Velocity" description="The speed of a batted ball immediately after bat-on-ball contact." unit="MPH" value="101.9"/>
<metric group="Batting" name="Launch Angle" description="The angle formed by the initial hit trajectory above or below the level xy-plane. " unit="Degrees" value="29"/>
<metric group="Batting" name="Barreled Ball" description="The classification assigned to a batted ball when comparable batted balls (in terms of exit velocity and launch angle) have historically led to a minimum .500 batting average and 1.500 slugging percentage." unit="String" value="Yes"/>
<metric group="Batting" name="Hit Probability" description="Hit Probability" unit="Percentage" value="69.1"/>
</metrics>
</player>
<player preferred_name="Cody" first_name="Cody" last_name="Poteet" jersey_number="38" id="fe85cdd5-32b3-4c92-bad1-7e8c48f580fb" full_name="Cody Poteet">
<metrics>
<metric group="Pitching" name="Spin Rate" description="The total rate of rotation of the ball during the pitch's flight." unit="RPM" value="2885"/>
<metric group="Pitching" name="Regular Speed" description="The speed of a pitch at release. " unit="MPH" value="81.1"/>
<metric group="Pitching" name="Extension" description="The distance from the pitching rubber to release point in the y-direction (from rubber to home plate)." unit="Feet" value="5.7"/>
</metrics>
</player>
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 |
{
"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
}
},
<game xmlns="http://feed.elasticstats.com/schema/baseball/v8/game.xsd" id="f6397a7e-5133-4481-b586-41dffca91b0f"
status="complete" coverage="full" game_number="1" day_night="D" scheduled="2024-10-07T20:08:00+00:00"
home_team="80715d0d-0d2a-450f-a970-1b9a3b18c7e7" away_team="575c19b7-4052-41c2-9f0a-1c5813d02f99"
ps_round="ALDS" ps_game="2" attendance="33650" duration="2:42" season_id="f23888ed-6ca7-45bf-99e1-24b7393f540c"
season_type="PST" season_year="2024" double_header="false" entry_mode="STOMP" reference="775325"
delay_duration="0:01">
<mound_visits>
<home used="3" remaining="1"/>
<away used="1" remaining="3"/>
</mound_visits>
<reviews>
<home used="0" remaining="1"/>
<away used="1" remaining="0"/>
</reviews>
<time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
<venue name="Progressive Field" market="Cleveland" capacity="34788" surface="grass" address="2401 Ontario Street" city="Cleveland" state="OH" zip="44115" country="USA" id="2b0ccd49-4d87-4996-ac4d-27ffc7ee4c16" field_orientation="N" stadium_type="outdoor" time_zone="US/Eastern">
<location lat="41.4957048" lng="-81.6852732"/>
</venue>
<broadcasts>
<broadcast network="Max" type="Internet" locale="National"/>
<broadcast network="truTV" type="TV" locale="National" channel="246"/>
<broadcast network="TBS" type="TV" locale="National" channel="247"/>
</broadcasts>
<weather>
<forecast temp_f="62" condition="Partly cloudy" humidity="48" dew_point_f="42" cloud_cover="50" obs_time="2025-01-24T19:42:38.000+00:00">
<wind speed_mph="16" direction="NW"/>
</forecast>
<current_conditions temp_f="61" condition="Sunny" humidity="54" dew_point_f="44" cloud_cover="0" obs_time="2025-01-24T19:44:56.000+00:00">
<wind speed_mph="7" direction="W"/>
</current_conditions>
</weather>
<final inning="9" inning_half="B"/>
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. |
{
"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
}
},
<series title="World Series - NYY vs LAD" start_date="2024-10-25" id="2a147b27-e530-4f65-8277-162f221a7724" round="WS" best_of="7" status="closed" parent_id="b6196892-571c-44a6-a5cd-5ff6aaadf973">
<participant name="Dodgers" record="4">
<team name="Dodgers" market="Los Angeles" abbr="LAD" id="ef64da7f-cfaf-4300-87b0-9313386b977c" seed="1"/>
</participant>
<participant name="Yankees" record="1">
<team name="Yankees" market="New York" abbr="NYY" id="a09ec676-f887-43dc-bbb3-cf4bbaee9a18" seed="1"/>
</participant>
Officials Endpoint
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 02/03/2025 | Officials | We have added an Officials RESTful endpoint. Request this to get a complete list of all umpires in the league with their unique IDs and officiating tenures. |
{
"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"
},
<league xmlns="http://feed.elasticstats.com/schema/baseball/v8/officials.xsd" alias="MLB" name="Major League Baseball" id="2fa448bc-fc17-4d3d-be03-e60e080fdc26">
<official experience="24" first_name="Jerry" full_name="Jerry Lane" last_name="Lane (DUP)" id="0357636a-7ac6-4c7d-a9d6-f08cea369d7d"/>
<official experience="9" first_name="Will" full_name="Will Little" last_name="Little" id="0d38d676-118b-4488-8353-7b4181104997"/>
<official experience="12" first_name="Vic" full_name="Vic Carapazza" last_name="Carapazza" id="0d57e1c7-e3dc-4d12-83e7-a2fcb80a0aeb"/>
<official experience="22" first_name="Greg" full_name="Greg Gibson" last_name="Gibson" id="163280b5-dcf4-4fed-a0b1-1611eec98758"/>
<official experience="34" first_name="Jerry" full_name="Jerry Layne" last_name="Layne" id="1d5d2733-d7c3-4ab2-8fca-6456c83926fe"/>
<official experience="9" first_name="Quinn" full_name="Quinn Wolcott" last_name="Wolcott" id="1f751c16-bec1-446a-8c34-89bf0ffdabb9"/>
<official experience="20" first_name="Mike" full_name="Mike Everitt" last_name="Everitt" id="23014392-971f-4400-a580-a9b7def8e5c0"/>
<official experience="16" first_name="Paul" full_name="Paul Schrieber" last_name="Schrieber" id="245a7a9c-fc69-459e-acc5-77b7092f02f7"/>
<official experience="30" first_name="Angel" full_name="Angel Hernandez" last_name="Hernandez" id="25544277-69b0-4c6c-b8ad-b363db64e83a"/>
<official experience="24" first_name="Mark" full_name="Mark Wegner" last_name="Wegner" id="27109ca4-3484-45ad-a78d-1a639c1bfabd"/>
<official first_name="Mark" full_name="Mark Lollo" last_name="Lollo" id="274941a9-348e-4442-8fa9-e07bbe13a15a"/>
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 |
|
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. |