Find all updates to the MLB v8 API and its documentation
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. |