Find all updates to the MLB v8 API and its documentation
Season Teams Sort in Player Profile
Release Date | Feeds Affected | Benefit |
---|---|---|
06/27/2025 | Player Profile | We've adjusted the behavior of our Player Profile endpoint to always sort each season entry to display the most recent team first. You may now use this endpoint to reliably infer the current team for a player.In the below example, Rafael Devers was traded from the Red Sox to the Giants in the 2025 regular season. The 2025 regular season entry ( season id="a91f72a5-9812-4acd-b3fd-482cb31468cd" year="2024" type="REG" ) displays his Giants statistics first, indicating it was the last team he recorded statistics for in the 2025 regular season.Sample Request: mlb/trial/v8/en/players/fe966998-15e1-4022-89d5-6b4750516176/profile.json |
{
"player": {
"id": "fe966998-15e1-4022-89d5-6b4750516176",
"status": "A",
"position": "DH",
"primary_position": "DH",
"first_name": "Rafael",
"last_name": "Devers",
"preferred_name": "Rafael",
"jersey_number": "16",
"full_name": "Rafael Devers",
"height": "72",
"weight": "235",
"throw_hand": "R",
"bat_hand": "L",
"birthdate": "1996-10-24",
"birthcountry": "DOM",
"birthcity": "Sanchez",
"pro_debut": "2017-07-25",
"updated": "2025-06-18T13:27:07+00:00",
"salary": 31318182,
"rookie_year": 2017,
"reference": "646240",
"team": {
"name": "Giants",
"market": "San Francisco",
"abbr": "SF",
"id": "a7723160-10b7-4277-a309-d8dd95a8ae65"
},
"seasons": [
{
"id": "a91f72a5-9812-4acd-b3fd-482cb31468cd",
"year": 2025,
"type": "REG",
"teams": [
{
"name": "Giants",
"market": "San Francisco",
"abbr": "SF",
"id": "a7723160-10b7-4277-a309-d8dd95a8ae65",
"statistics": {
"hitting": {
"overall": {
"ab": 35,
"lob": 10,
"rbi": 5,
"abhr": 17.5,
"abk": 3.889,
"bip": 24,
"babip": 0.292,
"bbk": 0.556,
"bbpa": 0.125,
"iso": 0.229,
"obp": 0.35,
"ops": 0.836,
"seca": 0.371,
"slg": 0.486,
"xbh": 4,
"pitch_count": 152,
"lob_risp_2out": 0,
"team_lob": 0,
"ab_risp": 3,
"hit_risp": 0,
"rbi_2out": 2,
"linedrive": 3,
"groundball": 13,
"popup": 1,
"flyball": 9,
"ap": 40,
"avg": ".257",
"gofo": 1.43,
"woba": 0.364208,
"wraa": 1.62073,
"war": 0.13782,
"bwar": 1.68271,
"fwar": 0,
"brwar": -0.684725,
"wgdp": 0,
"wrc": 6.23598,
"wrc_plus": 135.993,
"onbase": {
"s": 5,
"d": 2,
"t": 0,
"hr": 2,
"tb": 17,
"bb": 5,
"ibb": 0,
"hbp": 0,
"fc": 1,
"roe": 0,
"h": 9,
"ci": 0,
"rov": 0,
"cycle": 0
},
"runs": {
"total": 3
},
"outcome": {
"klook": 20,
"kswing": 19,
"ktotal": 39,
"ball": 53,
"iball": 0,
"dirtball": 5,
"foul": 29
},
"outs": {
"po": 1,
"fo": 6,
"fidp": 0,
"lo": 0,
"lidp": 0,
"go": 10,
"gidp": 0,
"klook": 2,
"kswing": 7,
"ktotal": 9,
"sacfly": 0,
"sachit": 0
},
"steal": {
"caught": 0,
"stolen": 0,
"pct": 0,
"pickoff": 0
},
"pitches": {
"count": 152,
"btotal": 58,
"ktotal": 94
},
"games": {
"start": 9,
"play": 9,
"finish": 0,
"complete": 9
}
}
}
},
"splits": {
"hitting": {
"overall": [
{
"total": [
{
"ab": 35,
"runs": 3,
"s": 5,
"d": 2,
"t": 0,
"hr": 2,
"rbi": 5,
"bb": 5,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.35,
"slg": 0.486,
"ops": 0.836,
"h": 9,
"ktotal": 9,
"avg": ".257"
}
],
"day_night": [
{
"value": "night",
"ab": 21,
"runs": 0,
"s": 2,
"d": 1,
"t": 0,
"hr": 0,
"rbi": 1,
"bb": 2,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.217,
"slg": 0.19,
"ops": 0.407,
"h": 3,
"ktotal": 5,
"avg": ".143"
},
{
"value": "day",
"ab": 14,
"runs": 3,
"s": 3,
"d": 1,
"t": 0,
"hr": 2,
"rbi": 4,
"bb": 3,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.529,
"slg": 0.929,
"ops": 1.458,
"h": 6,
"ktotal": 4,
"avg": ".429"
}
],
"venue": [
{
"id": "2d7542f5-7b80-49f7-9b24-c53ffdc75af6",
"name": "Oracle Park",
"market": "San Francisco",
"surface": "grass",
"ab": 35,
"runs": 3,
"s": 5,
"d": 2,
"t": 0,
"hr": 2,
"rbi": 5,
"bb": 5,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.35,
"slg": 0.486,
"ops": 0.836,
"h": 9,
"ktotal": 9,
"avg": ".257"
}
],
"surface": [
{
"value": "grass",
"ab": 35,
"runs": 3,
"s": 5,
"d": 2,
"t": 0,
"hr": 2,
"rbi": 5,
"bb": 5,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.35,
"slg": 0.486,
"ops": 0.836,
"h": 9,
"ktotal": 9,
"avg": ".257"
}
],
"month": [
{
"value": "6",
"ab": 35,
"runs": 3,
"s": 5,
"d": 2,
"t": 0,
"hr": 2,
"rbi": 5,
"bb": 5,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.35,
"slg": 0.486,
"ops": 0.836,
"h": 9,
"ktotal": 9,
"avg": ".257"
}
],
"home_away": [
{
"value": "home",
"ab": 35,
"runs": 3,
"s": 5,
"d": 2,
"t": 0,
"hr": 2,
"rbi": 5,
"bb": 5,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.35,
"slg": 0.486,
"ops": 0.836,
"h": 9,
"ktotal": 9,
"avg": ".257"
}
],
"pitcher_hand": [
{
"value": "R",
"ab": 25,
"runs": 2,
"s": 4,
"d": 2,
"t": 0,
"hr": 2,
"rbi": 5,
"bb": 3,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.393,
"slg": 0.64,
"ops": 1.033,
"h": 8,
"ktotal": 5,
"avg": ".320"
},
{
"value": "L",
"ab": 10,
"runs": 1,
"s": 1,
"d": 0,
"t": 0,
"hr": 0,
"rbi": 0,
"bb": 2,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.25,
"slg": 0.1,
"ops": 0.35,
"h": 1,
"ktotal": 4,
"avg": ".100"
}
],
"opponent": [
{
"id": "03556285-bdbb-4576-a06d-42f71f46ddc5",
"name": "Marlins",
"market": "Miami",
"abbr": "MIA",
"ab": 12,
"runs": 1,
"s": 2,
"d": 1,
"t": 0,
"hr": 1,
"rbi": 2,
"bb": 2,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.429,
"slg": 0.667,
"ops": 1.096,
"h": 4,
"ktotal": 2,
"avg": ".333"
},
{
"id": "93941372-eb4c-4c40-aced-fe3267174393",
"name": "Red Sox",
"market": "Boston",
"abbr": "BOS",
"ab": 12,
"runs": 2,
"s": 1,
"d": 0,
"t": 0,
"hr": 1,
"rbi": 2,
"bb": 1,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.231,
"slg": 0.417,
"ops": 0.648,
"h": 2,
"ktotal": 3,
"avg": ".167"
},
{
"id": "80715d0d-0d2a-450f-a970-1b9a3b18c7e7",
"name": "Guardians",
"market": "Cleveland",
"abbr": "CLE",
"ab": 11,
"runs": 0,
"s": 2,
"d": 1,
"t": 0,
"hr": 0,
"rbi": 1,
"bb": 2,
"ibb": 0,
"hbp": 0,
"sb": 0,
"cs": 0,
"obp": 0.385,
"slg": 0.364,
"ops": 0.749,
"h": 3,
"ktotal": 4,
"avg": ".273"
}
]
}
]
}
}
},
{
"name": "Red Sox",
"market": "Boston",
"abbr": "BOS",
"id": "93941372-eb4c-4c40-aced-fe3267174393",
"statistics": {
"hitting": {
"overall": {
"ab": 272,
"lob": 118,
"rbi": 58,
"abhr": 18.133,
"abk": 3.579,
"bip": 183,
"babip": 0.322,
"bbk": 0.737,
"bbpa": 0.168,
"iso": 0.232,
"obp": 0.401,
"ops": 0.905,
"seca": 0.438,
"slg": 0.504,
"xbh": 33,
"pitch_count": 1389,
"lob_risp_2out": 26,
"team_lob": 47,
"ab_risp": 78,
"hit_risp": 23,
"rbi_2out": 19,
"linedrive": 47,
"groundball": 82,
"popup": 10,
"flyball": 59,
"ap": 334,
"avg": ".272",
"gofo": 1.11,
"woba": 0.388478,
"wraa": 20.0013,
"war": 2.07209,
"bwar": 18.2137,
"fwar": 0,
"brwar": -1.51289,
"wgdp": 0,
"wrc": 58.5386,
"wrc_plus": 147.876,
"onbase": {
"s": 41,
"d": 18,
"t": 0,
"hr": 15,
"tb": 137,
"bb": 49,
"ibb": 7,
"hbp": 4,
"fc": 5,
"roe": 2,
"h": 74,
"ci": 0,
"rov": 0,
"cycle": 0
},
"runs": {
"total": 47
},
"outcome": {
"klook": 150,
"kswing": 224,
"ktotal": 374,
"ball": 521,
"iball": 0,
"dirtball": 35,
"foul": 257
},
"outs": {
"po": 10,
"fo": 34,
"fidp": 0,
"lo": 18,
"lidp": 0,
"go": 69,
"gidp": 7,
"klook": 16,
"kswing": 60,
"ktotal": 76,
"sacfly": 2,
"sachit": 0
},
"steal": {
"caught": 1,
"stolen": 1,
"pct": 0.5,
"pickoff": 0
},
"pitches": {
"count": 1389,
"btotal": 560,
"ktotal": 829
},
"games": {
"start": 73,
"play": 73,
"finish": 0,
"complete": 71
}
}
}
},
--snip--
},
<player xmlns="http://feed.elasticstats.com/schema/baseball/v8/profile.xsd" id="fe966998-15e1-4022-89d5-6b4750516176" status="A" position="DH" primary_position="DH" first_name="Rafael" last_name="Devers" preferred_name="Rafael" jersey_number="16" full_name="Rafael Devers" height="72" weight="235" throw_hand="R" bat_hand="L" birthdate="1996-10-24" birthcountry="DOM" birthcity="Sanchez" pro_debut="2017-07-25" updated="2025-06-18T13:27:07+00:00" salary="31318182" rookie_year="2017" reference="646240">
<team name="Giants" market="San Francisco" abbr="SF" id="a7723160-10b7-4277-a309-d8dd95a8ae65"/>
<seasons>
<season id="a91f72a5-9812-4acd-b3fd-482cb31468cd" year="2025" type="REG">
--snip--
<team name="Giants" market="San Francisco" abbr="SF" id="a7723160-10b7-4277-a309-d8dd95a8ae65">
<statistics>
<hitting>
<overall ab="35" lob="10" rbi="5" abhr="17.5" abk="3.889" bip="24" babip="0.292" bbk="0.556" bbpa="0.125" iso="0.229" obp="0.35" ops="0.836" seca="0.371" slg="0.486" xbh="4" pitch_count="152" lob_risp_2out="0" team_lob="0" ab_risp="3" hit_risp="0" rbi_2out="2" linedrive="3" groundball="13" popup="1" flyball="9" ap="40" avg=".257" gofo="1.43" woba="0.364208" wraa="1.62073" war="0.13782" bwar="1.68271" fwar="0.0" brwar="-0.684725" wgdp="0.0" wrc="6.23598" wrc_plus="135.993">
<onbase s="5" d="2" t="0" hr="2" tb="17" bb="5" ibb="0" hbp="0" fc="1" roe="0" h="9" ci="0" rov="0" cycle="0"/>
<runs total="3"/>
<outcome klook="20" kswing="19" ktotal="39" ball="53" iball="0" dirtball="5" foul="29"/>
<outs po="1" fo="6" fidp="0" lo="0" lidp="0" go="10" gidp="0" klook="2" kswing="7" ktotal="9" sacfly="0" sachit="0"/>
<steal caught="0" stolen="0" pct="0" pickoff="0"/>
<pitches count="152" btotal="58" ktotal="94"/>
<games start="9" play="9" finish="0" complete="9"/>
</overall>
</hitting>
</statistics>
<splits>
<hitting>
<overall>
<total>
<statistics ab="35" runs="3" s="5" d="2" t="0" hr="2" rbi="5" bb="5" ibb="0" hbp="0" sb="0" cs="0" obp="0.35" slg="0.486" ops="0.836" h="9" ktotal="9" avg=".257"/>
</total>
<day_night value="night">
<statistics ab="21" runs="0" s="2" d="1" t="0" hr="0" rbi="1" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.217" slg="0.19" ops="0.407" h="3" ktotal="5" avg=".143"/>
</day_night>
<day_night value="day">
<statistics ab="14" runs="3" s="3" d="1" t="0" hr="2" rbi="4" bb="3" ibb="0" hbp="0" sb="0" cs="0" obp="0.529" slg="0.929" ops="1.458" h="6" ktotal="4" avg=".429"/>
</day_night>
<venue id="2d7542f5-7b80-49f7-9b24-c53ffdc75af6" name="Oracle Park" market="San Francisco" surface="grass">
<statistics ab="35" runs="3" s="5" d="2" t="0" hr="2" rbi="5" bb="5" ibb="0" hbp="0" sb="0" cs="0" obp="0.35" slg="0.486" ops="0.836" h="9" ktotal="9" avg=".257"/>
</venue>
<surface value="grass">
<statistics ab="35" runs="3" s="5" d="2" t="0" hr="2" rbi="5" bb="5" ibb="0" hbp="0" sb="0" cs="0" obp="0.35" slg="0.486" ops="0.836" h="9" ktotal="9" avg=".257"/>
</surface>
<month value="6">
<statistics ab="35" runs="3" s="5" d="2" t="0" hr="2" rbi="5" bb="5" ibb="0" hbp="0" sb="0" cs="0" obp="0.35" slg="0.486" ops="0.836" h="9" ktotal="9" avg=".257"/>
</month>
<home_away value="home">
<statistics ab="35" runs="3" s="5" d="2" t="0" hr="2" rbi="5" bb="5" ibb="0" hbp="0" sb="0" cs="0" obp="0.35" slg="0.486" ops="0.836" h="9" ktotal="9" avg=".257"/>
</home_away>
<pitcher_hand value="R">
<statistics ab="25" runs="2" s="4" d="2" t="0" hr="2" rbi="5" bb="3" ibb="0" hbp="0" sb="0" cs="0" obp="0.393" slg="0.64" ops="1.033" h="8" ktotal="5" avg=".320"/>
</pitcher_hand>
<pitcher_hand value="L">
<statistics ab="10" runs="1" s="1" d="0" t="0" hr="0" rbi="0" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.25" slg="0.1" ops="0.35" h="1" ktotal="4" avg=".100"/>
</pitcher_hand>
<opponent id="03556285-bdbb-4576-a06d-42f71f46ddc5" name="Marlins" market="Miami" abbr="MIA">
<statistics ab="12" runs="1" s="2" d="1" t="0" hr="1" rbi="2" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.429" slg="0.667" ops="1.096" h="4" ktotal="2" avg=".333"/>
</opponent>
<opponent id="93941372-eb4c-4c40-aced-fe3267174393" name="Red Sox" market="Boston" abbr="BOS">
<statistics ab="12" runs="2" s="1" d="0" t="0" hr="1" rbi="2" bb="1" ibb="0" hbp="0" sb="0" cs="0" obp="0.231" slg="0.417" ops="0.648" h="2" ktotal="3" avg=".167"/>
</opponent>
<opponent id="80715d0d-0d2a-450f-a970-1b9a3b18c7e7" name="Guardians" market="Cleveland" abbr="CLE">
<statistics ab="11" runs="0" s="2" d="1" t="0" hr="0" rbi="1" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.385" slg="0.364" ops="0.749" h="3" ktotal="4" avg=".273"/>
</opponent>
</overall>
</hitting>
</splits>
</team>
<team name="Red Sox" market="Boston" abbr="BOS" id="93941372-eb4c-4c40-aced-fe3267174393">
<statistics>
<hitting>
<overall ab="272" lob="118" rbi="58" abhr="18.133" abk="3.579" bip="183" babip="0.322" bbk="0.737" bbpa="0.168" iso="0.232" obp="0.401" ops="0.905" seca="0.438" slg="0.504" xbh="33" pitch_count="1389" lob_risp_2out="26" team_lob="47" ab_risp="78" hit_risp="23" rbi_2out="19" linedrive="47" groundball="82" popup="10" flyball="59" ap="334" avg=".272" gofo="1.11" woba="0.388478" wraa="20.0013" war="2.07209" bwar="18.2137" fwar="0.0" brwar="-1.51289" wgdp="0.0" wrc="58.5386" wrc_plus="147.876">
<onbase s="41" d="18" t="0" hr="15" tb="137" bb="49" ibb="7" hbp="4" fc="5" roe="2" h="74" ci="0" rov="0" cycle="0"/>
<runs total="47"/>
<outcome klook="150" kswing="224" ktotal="374" ball="521" iball="0" dirtball="35" foul="257"/>
<outs po="10" fo="34" fidp="0" lo="18" lidp="0" go="69" gidp="7" klook="16" kswing="60" ktotal="76" sacfly="2" sachit="0"/>
<steal caught="1" stolen="1" pct="0.5" pickoff="0"/>
<pitches count="1389" btotal="560" ktotal="829"/>
<games start="73" play="73" finish="0" complete="71"/>
</overall>
</hitting>
</statistics>
<splits>
<hitting>
<overall>
<total>
<statistics ab="272" runs="47" s="41" d="18" t="0" hr="15" rbi="58" bb="49" ibb="7" hbp="4" sb="1" cs="1" obp="0.401" slg="0.504" ops="0.905" h="74" ktotal="76" avg=".272"/>
</total>
<day_night value="night">
<statistics ab="163" runs="27" s="25" d="15" t="0" hr="5" rbi="27" bb="28" ibb="3" hbp="3" sb="0" cs="1" obp="0.397" slg="0.46" ops="0.857" h="45" ktotal="46" avg=".276"/>
</day_night>
<day_night value="day">
<statistics ab="109" runs="20" s="16" d="3" t="0" hr="10" rbi="31" bb="21" ibb="4" hbp="1" sb="1" cs="0" obp="0.407" slg="0.569" ops="0.976" h="29" ktotal="30" avg=".266"/>
</day_night>
<venue id="ef9a5eef-06c6-4963-ac70-7fd02c8c8d42" name="Comerica Park" market="Detroit" surface="grass">
<statistics ab="12" runs="1" s="3" d="0" t="0" hr="0" rbi="1" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.357" slg="0.25" ops="0.607" h="3" ktotal="5" avg=".250"/>
</venue>
<venue id="3ca8b577-5844-42ed-81a5-bd5d5cbe350c" name="Truist Park" market="Atlanta" surface="grass">
<statistics ab="11" runs="1" s="2" d="1" t="0" hr="0" rbi="2" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.385" slg="0.364" ops="0.749" h="3" ktotal="4" avg=".273"/>
</venue>
<venue id="706e9828-6687-4ac8-a409-3fb972e8bae9" name="Yankee Stadium" market="New York" surface="grass">
<statistics ab="12" runs="4" s="0" d="1" t="0" hr="2" rbi="3" bb="1" ibb="0" hbp="2" sb="0" cs="0" obp="0.4" slg="0.833" ops="1.233" h="3" ktotal="2" avg=".250"/>
</venue>
<venue id="434aa63c-1049-4a54-a6bc-3790c7772ee1" name="Oriole Park at Camden Yards" market="Baltimore" surface="grass">
<statistics ab="11" runs="2" s="2" d="1" t="0" hr="0" rbi="1" bb="3" ibb="0" hbp="0" sb="0" cs="0" obp="0.429" slg="0.364" ops="0.793" h="3" ktotal="4" avg=".273"/>
</venue>
<venue id="3d13c8a7-283f-482b-ade1-441e25b6465d" name="American Family Field" market="Milwaukee" surface="grass">
<statistics ab="10" runs="1" s="2" d="0" t="0" hr="0" rbi="2" bb="4" ibb="1" hbp="0" sb="0" cs="0" obp="0.467" slg="0.2" ops="0.667" h="2" ktotal="3" avg=".200"/>
</venue>
<venue id="4a550fc1-c03d-4294-b63a-30ff197bedc4" name="Rate Field" market="Chicago" surface="grass">
<statistics ab="10" runs="0" s="0" d="0" t="0" hr="0" rbi="0" bb="2" ibb="1" hbp="0" sb="0" cs="0" obp="0.231" slg="0.0" ops="0.231" h="0" ktotal="5" avg=".000"/>
</venue>
<venue id="6fca95c9-7f2c-4acb-a9f3-02ef96340d2a" name="Kauffman Stadium" market="Kansas City" surface="grass">
<statistics ab="12" runs="2" s="5" d="1" t="0" hr="1" rbi="6" bb="1" ibb="1" hbp="0" sb="0" cs="0" obp="0.643" slg="0.917" ops="1.56" h="7" ktotal="1" avg=".583"/>
</venue>
<venue id="b4372592-9dac-4387-864b-dfc94dffd645" name="Globe Life Field" market="Texas" surface="turf">
<statistics ab="16" runs="0" s="0" d="0" t="0" hr="0" rbi="1" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.111" slg="0.0" ops="0.111" h="0" ktotal="12" avg=".000"/>
</venue>
<venue id="84d72338-2173-4a90-9d25-99adc6c86f4b" name="Rogers Centre" market="Toronto" surface="turf">
<statistics ab="12" runs="2" s="1" d="2" t="0" hr="1" rbi="2" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.429" slg="0.75" ops="1.179" h="4" ktotal="3" avg=".333"/>
</venue>
<venue id="fca673a0-c7f8-42c3-868b-5bcb681c089d" name="George M. Steinbrenner Field" market="Tampa Bay" surface="grass">
<statistics ab="11" runs="1" s="1" d="1" t="0" hr="0" rbi="0" bb="1" ibb="0" hbp="0" sb="0" cs="0" obp="0.25" slg="0.273" ops="0.523" h="2" ktotal="3" avg=".182"/>
</venue>
<venue id="b27b0dc5-c2c5-401d-b8b9-a6a2dbc225e5" name="Fenway Park" market="Boston" surface="grass">
<statistics ab="142" runs="28" s="23" d="10" t="0" hr="9" rbi="37" bb="27" ibb="4" hbp="1" sb="1" cs="1" obp="0.42" slg="0.556" ops="0.976" h="42" ktotal="32" avg=".296"/>
</venue>
<venue id="2b0ccd49-4d87-4996-ac4d-27ffc7ee4c16" name="Progressive Field" market="Cleveland" surface="grass">
<statistics ab="13" runs="5" s="2" d="1" t="0" hr="2" rbi="3" bb="2" ibb="0" hbp="1" sb="0" cs="0" obp="0.5" slg="0.923" ops="1.423" h="5" ktotal="2" avg=".385"/>
</venue>
<surface value="turf">
<statistics ab="28" runs="2" s="1" d="2" t="0" hr="1" rbi="3" bb="4" ibb="0" hbp="0" sb="0" cs="0" obp="0.25" slg="0.321" ops="0.571" h="4" ktotal="15" avg=".143"/>
</surface>
<surface value="grass">
<statistics ab="244" runs="45" s="40" d="16" t="0" hr="14" rbi="55" bb="45" ibb="7" hbp="4" sb="1" cs="1" obp="0.417" slg="0.525" ops="0.942" h="70" ktotal="61" avg=".287"/>
</surface>
<month value="4">
<statistics ab="101" runs="22" s="12" d="10" t="0" hr="5" rbi="18" bb="18" ibb="2" hbp="1" sb="0" cs="0" obp="0.387" slg="0.515" ops="0.902" h="27" ktotal="25" avg=".267"/>
</month>
<month value="3">
<statistics ab="19" runs="0" s="0" d="0" t="0" hr="0" rbi="1" bb="4" ibb="0" hbp="0" sb="0" cs="0" obp="0.174" slg="0.0" ops="0.174" h="0" ktotal="15" avg=".000"/>
</month>
<month value="5">
<statistics ab="104" runs="14" s="25" d="5" t="0" hr="7" rbi="33" bb="20" ibb="2" hbp="0" sb="1" cs="1" obp="0.468" slg="0.606" ops="1.074" h="37" ktotal="23" avg=".356"/>
</month>
<month value="6">
<statistics ab="48" runs="11" s="4" d="3" t="0" hr="3" rbi="6" bb="7" ibb="3" hbp="3" sb="0" cs="0" obp="0.377" slg="0.458" ops="0.835" h="10" ktotal="13" avg=".208"/>
</month>
<home_away value="away">
<statistics ab="130" runs="19" s="18" d="8" t="0" hr="6" rbi="21" bb="22" ibb="3" hbp="3" sb="0" cs="0" obp="0.38" slg="0.446" ops="0.826" h="32" ktotal="44" avg=".246"/>
</home_away>
<home_away value="home">
<statistics ab="142" runs="28" s="23" d="10" t="0" hr="9" rbi="37" bb="27" ibb="4" hbp="1" sb="1" cs="1" obp="0.42" slg="0.556" ops="0.976" h="42" ktotal="32" avg=".296"/>
</home_away>
<pitcher_hand value="L">
<statistics ab="104" runs="17" s="19" d="7" t="0" hr="5" rbi="24" bb="10" ibb="3" hbp="3" sb="0" cs="1" obp="0.392" slg="0.51" ops="0.902" h="31" ktotal="27" avg=".298"/>
</pitcher_hand>
<pitcher_hand value="R">
<statistics ab="168" runs="30" s="22" d="11" t="0" hr="10" rbi="34" bb="39" ibb="4" hbp="1" sb="1" cs="0" obp="0.407" slg="0.5" ops="0.907" h="43" ktotal="49" avg=".256"/>
</pitcher_hand>
<opponent id="75729d34-bca7-4a0f-b3df-6f26c6ad3719" name="Orioles" market="Baltimore" abbr="BAL">
<statistics ab="29" runs="6" s="5" d="2" t="0" hr="2" rbi="10" bb="4" ibb="0" hbp="0" sb="0" cs="0" obp="0.394" slg="0.586" ops="0.98" h="9" ktotal="6" avg=".310"/>
</opponent>
<opponent id="47f490cd-2f58-4ef7-9dfd-2ad6ba6c1ae8" name="White Sox" market="Chicago" abbr="CWS">
<statistics ab="24" runs="4" s="0" d="1" t="0" hr="1" rbi="3" bb="6" ibb="2" hbp="0" sb="0" cs="0" obp="0.313" slg="0.25" ops="0.563" h="2" ktotal="8" avg=".083"/>
</opponent>
<opponent id="4f735188-37c8-473d-ae32-1f7e34ccf892" name="Angels" market="Los Angeles" abbr="LAA">
<statistics ab="12" runs="2" s="2" d="1" t="0" hr="0" rbi="2" bb="2" ibb="1" hbp="0" sb="0" cs="0" obp="0.4" slg="0.333" ops="0.733" h="3" ktotal="2" avg=".250"/>
</opponent>
<opponent id="aa34e0ed-f342-4ec6-b774-c79b47b60e2d" name="Twins" market="Minnesota" abbr="MIN">
<statistics ab="13" runs="0" s="5" d="1" t="0" hr="0" rbi="4" bb="1" ibb="0" hbp="0" sb="0" cs="0" obp="0.5" slg="0.538" ops="1.038" h="6" ktotal="3" avg=".462"/>
</opponent>
<opponent id="dcfd5266-00ce-442c-bc09-264cd20cf455" name="Brewers" market="Milwaukee" abbr="MIL">
<statistics ab="10" runs="1" s="2" d="0" t="0" hr="0" rbi="2" bb="4" ibb="1" hbp="0" sb="0" cs="0" obp="0.467" slg="0.2" ops="0.667" h="2" ktotal="3" avg=".200"/>
</opponent>
<opponent id="12079497-e414-450a-8bf2-29f91de646bf" name="Braves" market="Atlanta" abbr="ATL">
<statistics ab="22" runs="4" s="3" d="3" t="0" hr="2" rbi="8" bb="4" ibb="0" hbp="0" sb="0" cs="1" obp="0.462" slg="0.773" ops="1.235" h="8" ktotal="6" avg=".364"/>
</opponent>
<opponent id="833a51a9-0d84-410f-bd77-da08c3e5e26e" name="Royals" market="Kansas City" abbr="KC">
<statistics ab="12" runs="2" s="5" d="1" t="0" hr="1" rbi="6" bb="1" ibb="1" hbp="0" sb="0" cs="0" obp="0.643" slg="0.917" ops="1.56" h="7" ktotal="1" avg=".583"/>
</opponent>
<opponent id="f246a5e5-afdb-479c-9aaa-c68beeda7af6" name="Mets" market="New York" abbr="NYM">
<statistics ab="8" runs="2" s="1" d="0" t="0" hr="1" rbi="1" bb="4" ibb="0" hbp="0" sb="0" cs="0" obp="0.5" slg="0.625" ops="1.125" h="2" ktotal="1" avg=".250"/>
</opponent>
<opponent id="1d678440-b4b1-4954-9b39-70afb3ebbcfa" name="Blue Jays" market="Toronto" abbr="TOR">
<statistics ab="28" runs="2" s="4" d="4" t="0" hr="1" rbi="3" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.355" slg="0.571" ops="0.926" h="9" ktotal="6" avg=".321"/>
</opponent>
<opponent id="43a39081-52b4-4f93-ad29-da7f329ea960" name="Mariners" market="Seattle" abbr="SEA">
<statistics ab="9" runs="2" s="0" d="0" t="0" hr="0" rbi="2" bb="3" ibb="0" hbp="0" sb="0" cs="0" obp="0.231" slg="0.0" ops="0.231" h="0" ktotal="5" avg=".000"/>
</opponent>
<opponent id="44671792-dc02-4fdd-a5ad-f5f17edaa9d7" name="Cardinals" market="St. Louis" abbr="STL">
<statistics ab="11" runs="6" s="4" d="2" t="0" hr="1" rbi="6" bb="4" ibb="0" hbp="0" sb="0" cs="0" obp="0.733" slg="1.091" ops="1.824" h="7" ktotal="1" avg=".636"/>
</opponent>
<opponent id="bdc11650-6f74-49c4-875e-778aeb7632d9" name="Rays" market="Tampa Bay" abbr="TB">
<statistics ab="21" runs="4" s="2" d="1" t="0" hr="0" rbi="0" bb="3" ibb="1" hbp="1" sb="0" cs="0" obp="0.308" slg="0.19" ops="0.498" h="3" ktotal="8" avg=".143"/>
</opponent>
<opponent id="80715d0d-0d2a-450f-a970-1b9a3b18c7e7" name="Guardians" market="Cleveland" abbr="CLE">
<statistics ab="13" runs="5" s="2" d="1" t="0" hr="2" rbi="3" bb="2" ibb="0" hbp="1" sb="0" cs="0" obp="0.5" slg="0.923" ops="1.423" h="5" ktotal="2" avg=".385"/>
</opponent>
<opponent id="575c19b7-4052-41c2-9f0a-1c5813d02f99" name="Tigers" market="Detroit" abbr="DET">
<statistics ab="12" runs="1" s="3" d="0" t="0" hr="0" rbi="1" bb="2" ibb="0" hbp="0" sb="0" cs="0" obp="0.357" slg="0.25" ops="0.607" h="3" ktotal="5" avg=".250"/>
</opponent>
<opponent id="a09ec676-f887-43dc-bbb3-cf4bbaee9a18" name="Yankees" market="New York" abbr="NYY">
<statistics ab="23" runs="5" s="1" d="1" t="0" hr="3" rbi="4" bb="2" ibb="1" hbp="2" sb="0" cs="0" obp="0.357" slg="0.652" ops="1.009" h="5" ktotal="5" avg=".217"/>
</opponent>
<opponent id="d99f919b-1534-4516-8e8a-9cd106c6d8cd" name="Rangers" market="Texas" abbr="TEX">
<statistics ab="25" runs="1" s="2" d="0" t="0" hr="1" rbi="3" bb="5" ibb="0" hbp="0" sb="1" cs="0" obp="0.267" slg="0.24" ops="0.507" h="3" ktotal="14" avg=".120"/>
</opponent>
</overall>
</hitting>
</splits>
</team>
</season>
Deprecated Seasonal Transactions Endpoint
Release Date | Feeds Affected | Benefit |
---|---|---|
06/25/2025 | Seasonal Transactions | We've deprecated the Seasonal Transactions endpoint. You may continue to access transactional data in the Daily Transactions endpoint. |
Times Through the Order
Release Date | Feeds Affected | Benefit |
---|---|---|
04/15/2025 | Daily Summary Game Extended Summary Game Summary | We've added a data point for the number of times a pitcher has pitched through the order in a game. This is available by game under times_through_order in each Summary endpoint, at the player level only. |
<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. |