Release Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

MLB API

Parent Ids

Release DateFeeds AffectedBenefit
03/20/2024Daily Boxscore

Daily Schedule

Daily Summary

Game Boxscore

Game Extended Summary

Game Pitch Metrics

Game Summary

League Schedule

Play-by-Play

Series Schedule
Added a standard parent Id (parent_id) to games and series.

Use this Id to group events (like the World Series or All-Star Game) across seasons.
<game id="645f60c6-1ac4-4c6b-bec8-c3b3e5c82c3f" status="closed" coverage="full" 
 game_number="1" day_night="N" scheduled="2023-07-12T00:00:00+00:00" home_team="dd59d49e-caee-4443-9220-f05d0d9bd1e1" 
 away_team="3bbb3b39-b5cb-4fc9-bd22-522521f0f329" attendance="47159" duration="3:03" 
 parent_id="34e4cbbe-0086-4fad-bb08-840cbcfcabf0" double_header="false" entry_mode="STOMP" 
 reference="717421">
{
    "league": {
        "alias": "MLB",
        "name": "Major League Baseball",
        "id": "2fa448bc-fc17-4d3d-be03-e60e080fdc26"
    },
    "date": "2023-07-11",
    "games": [
        {
            "id": "645f60c6-1ac4-4c6b-bec8-c3b3e5c82c3f",
            "status": "closed",
            "coverage": "full",
            "game_number": 1,
            "day_night": "N",
            "scheduled": "2023-07-12T00:00:00+00:00",
            "home_team": "dd59d49e-caee-4443-9220-f05d0d9bd1e1",
            "away_team": "3bbb3b39-b5cb-4fc9-bd22-522521f0f329",
            "attendance": 47159,
            "duration": "3:03",
            "parent_id": "34e4cbbe-0086-4fad-bb08-840cbcfcabf0",
            "double_header": false,
            "entry_mode": "STOMP",
            "reference": "717421",
            "venue": {
                "name": "T-Mobile Park",
                "market": "Seattle",
                "capacity": 47929,
                "surface": "grass",
                "address": "1516 First Avenue South",
                "city": "Seattle",
                "state": "WA",
                "zip": "98134",
                "country": "USA",
                "id": "f1c03dac-3c0f-437c-a325-8d5702cd321a",
                "field_orientation": "NE",
                "stadium_type": "retractable",
                "time_zone": "US/Pacific",
                "location": {
                    "lat": "47.5899037",
                    "lng": "-122.3337561"
                }
            },
            "home": {
                "name": "American League",
                "market": "AL",
                "abbr": "AL",
                "id": "dd59d49e-caee-4443-9220-f05d0d9bd1e1",
                "win": 0,
                "loss": 1
            },
            "away": {
                "name": "National League",
                "market": "NL",
                "abbr": "NL",
                "id": "3bbb3b39-b5cb-4fc9-bd22-522521f0f329",
                "win": 1,
                "loss": 0
            },
            "broadcast": {
                "network": "FOX"
            }
        }
    ],
<series title="World Series - ARI vs TEX" start_date="2023-10-27" id="f67437bd-9077-4c0d-9ee2-dae8ff860eb2" round="WS" best_of="7" status="closed" parent_id="b6196892-571c-44a6-a5cd-5ff6aaadf973">
	<participant name="Rangers" record="4">
		<team name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
	</participant>
	<participant name="Diamondbacks" record="1">
		<team name="Diamondbacks" market="Arizona" abbr="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
	</participant>
	<games>
		<game id="f7fc26fe-106f-48c5-ae8e-79d6c56cf357" status="closed" coverage="full" game_number="1" day_night="N" scheduled="2023-10-28T00:03:00+00:00" home_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" away_team="25507be1-6a68-4267-bd82-e097d94b359b" ps_round="WS" ps_game="1" attendance="42472" duration="4:02" double_header="false" entry_mode="STOMP" reference="748542">
			<venue name="Globe Life Field" market="Texas" capacity="40000" surface="turf" address="734 Stadium Drive" city="Arlington" state="TX" zip="76011" country="USA" id="b4372592-9dac-4387-864b-dfc94dffd645" field_orientation="SW" stadium_type="retractable" time_zone="US/Central">
				<location lat="32.747300" lng="-97.081820"/>
			</venue>
			<home name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<away name="Diamondbacks" market="Arizona" abbr="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<broadcast network="FOX"/>
		</game>
		<game id="65230957-eea6-4d4c-a284-fce1873f5b7a" status="closed" coverage="full" game_number="1" day_night="N" scheduled="2023-10-29T00:03:00+00:00" home_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" away_team="25507be1-6a68-4267-bd82-e097d94b359b" ps_round="WS" ps_game="2" attendance="42500" duration="2:59" double_header="false" entry_mode="STOMP" reference="748541">
			<venue name="Globe Life Field" market="Texas" capacity="40000" surface="turf" address="734 Stadium Drive" city="Arlington" state="TX" zip="76011" country="USA" id="b4372592-9dac-4387-864b-dfc94dffd645" field_orientation="SW" stadium_type="retractable" time_zone="US/Central">
				<location lat="32.747300" lng="-97.081820"/>
			</venue>
			<home name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<away name="Diamondbacks" market="Arizona" abbr="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<broadcast network="FOX"/>
		</game>
		<game id="9b6b7306-712b-408e-967b-abf02b5545bc" status="closed" coverage="full" game_number="1" day_night="N" scheduled="2023-10-31T00:03:00+00:00" home_team="25507be1-6a68-4267-bd82-e097d94b359b" away_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" ps_round="WS" ps_game="3" attendance="48517" duration="2:51" double_header="false" entry_mode="STOMP" reference="748540">
			<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="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<away name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<broadcast network="FOX"/>
		</game>
		<game id="c13cc205-a3f6-497e-84aa-9d8b289b32fe" status="closed" coverage="full" game_number="1" day_night="N" scheduled="2023-11-01T00:03:00+00:00" home_team="25507be1-6a68-4267-bd82-e097d94b359b" away_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" ps_round="WS" ps_game="4" attendance="48388" duration="3:18" double_header="false" entry_mode="STOMP" reference="748535">
			<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="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<away name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<broadcast network="FOX"/>
		</game>
		<game id="e072259f-2420-4bf9-aa44-092749ae2a73" status="closed" coverage="full" game_number="1" day_night="N" scheduled="2023-11-02T00:03:00+00:00" home_team="25507be1-6a68-4267-bd82-e097d94b359b" away_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" ps_round="WS" ps_game="5" attendance="48511" duration="2:54" double_header="false" entry_mode="STOMP" reference="748534">
			<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="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<away name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<broadcast network="FOX"/>
		</game>
		<game id="70c8a17e-f24f-4e6d-af58-cd209be612c6" status="unnecessary" coverage="full" game_number="1" day_night="N" scheduled="2023-11-04T00:03:00+00:00" home_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" away_team="25507be1-6a68-4267-bd82-e097d94b359b" ps_round="WS" ps_game="6" double_header="false" entry_mode="STOMP" reference="748533">
			<venue name="Globe Life Field" market="Texas" capacity="40000" surface="turf" address="734 Stadium Drive" city="Arlington" state="TX" zip="76011" country="USA" id="b4372592-9dac-4387-864b-dfc94dffd645" field_orientation="SW" stadium_type="retractable" time_zone="US/Central">
				<location lat="32.747300" lng="-97.081820"/>
			</venue>
			<home name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<away name="Diamondbacks" market="Arizona" abbr="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<broadcast network="FOX"/>
		</game>
		<game id="b5529e9a-25df-4923-93d7-3cf9dd91e013" status="unnecessary" coverage="full" game_number="1" day_night="N" scheduled="2023-11-05T00:03:00+00:00" home_team="d99f919b-1534-4516-8e8a-9cd106c6d8cd" away_team="25507be1-6a68-4267-bd82-e097d94b359b" ps_round="WS" ps_game="7" double_header="false" entry_mode="STOMP" reference="748536">
			<venue name="Globe Life Field" market="Texas" capacity="40000" surface="turf" address="734 Stadium Drive" city="Arlington" state="TX" zip="76011" country="USA" id="b4372592-9dac-4387-864b-dfc94dffd645" field_orientation="SW" stadium_type="retractable" time_zone="US/Central">
				<location lat="32.747300" lng="-97.081820"/>
			</venue>
			<home name="Rangers" market="Texas" abbr="TEX" id="d99f919b-1534-4516-8e8a-9cd106c6d8cd"/>
			<away name="Diamondbacks" market="Arizona" abbr="ARI" id="25507be1-6a68-4267-bd82-e097d94b359b"/>
			<broadcast network="FOX"/>
		</game>
	</games>
</series>
{
   "title":"World Series - ARI vs TEX",
   "start_date":"2023-10-27",
   "id":"f67437bd-9077-4c0d-9ee2-dae8ff860eb2",
   "round":"WS",
   "best_of":7,
   "status":"closed",
   "parent_id":"b6196892-571c-44a6-a5cd-5ff6aaadf973",
   "participants":[
      {
         "name":"Rangers",
         "record":4,
         "team":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         }
      },
      {
         "name":"Diamondbacks",
         "record":1,
         "team":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         }
      }
   ],
   "games":[
      {
         "id":"f7fc26fe-106f-48c5-ae8e-79d6c56cf357",
         "status":"closed",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-10-28T00:03:00+00:00",
         "home_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "away_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "ps_round":"WS",
         "ps_game":"1",
         "attendance":42472,
         "duration":"4:02",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748542",
         "venue":{
            "name":"Globe Life Field",
            "market":"Texas",
            "capacity":40000,
            "surface":"turf",
            "address":"734 Stadium Drive",
            "city":"Arlington",
            "state":"TX",
            "zip":"76011",
            "country":"USA",
            "id":"b4372592-9dac-4387-864b-dfc94dffd645",
            "field_orientation":"SW",
            "stadium_type":"retractable",
            "time_zone":"US/Central",
            "location":{
               "lat":"32.747300",
               "lng":"-97.081820"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         },
         "home":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         }
      },
      {
         "id":"65230957-eea6-4d4c-a284-fce1873f5b7a",
         "status":"closed",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-10-29T00:03:00+00:00",
         "home_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "away_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "ps_round":"WS",
         "ps_game":"2",
         "attendance":42500,
         "duration":"2:59",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748541",
         "venue":{
            "name":"Globe Life Field",
            "market":"Texas",
            "capacity":40000,
            "surface":"turf",
            "address":"734 Stadium Drive",
            "city":"Arlington",
            "state":"TX",
            "zip":"76011",
            "country":"USA",
            "id":"b4372592-9dac-4387-864b-dfc94dffd645",
            "field_orientation":"SW",
            "stadium_type":"retractable",
            "time_zone":"US/Central",
            "location":{
               "lat":"32.747300",
               "lng":"-97.081820"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         },
         "home":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         }
      },
      {
         "id":"9b6b7306-712b-408e-967b-abf02b5545bc",
         "status":"closed",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-10-31T00:03:00+00:00",
         "home_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "away_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "ps_round":"WS",
         "ps_game":"3",
         "attendance":48517,
         "duration":"2:51",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748540",
         "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"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         },
         "home":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         }
      },
      {
         "id":"c13cc205-a3f6-497e-84aa-9d8b289b32fe",
         "status":"closed",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-11-01T00:03:00+00:00",
         "home_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "away_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "ps_round":"WS",
         "ps_game":"4",
         "attendance":48388,
         "duration":"3:18",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748535",
         "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"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         },
         "home":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         }
      },
      {
         "id":"e072259f-2420-4bf9-aa44-092749ae2a73",
         "status":"closed",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-11-02T00:03:00+00:00",
         "home_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "away_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "ps_round":"WS",
         "ps_game":"5",
         "attendance":48511,
         "duration":"2:54",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748534",
         "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"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         },
         "home":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         }
      },
      {
         "id":"70c8a17e-f24f-4e6d-af58-cd209be612c6",
         "status":"unnecessary",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-11-04T00:03:00+00:00",
         "home_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "away_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "ps_round":"WS",
         "ps_game":"6",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748533",
         "venue":{
            "name":"Globe Life Field",
            "market":"Texas",
            "capacity":40000,
            "surface":"turf",
            "address":"734 Stadium Drive",
            "city":"Arlington",
            "state":"TX",
            "zip":"76011",
            "country":"USA",
            "id":"b4372592-9dac-4387-864b-dfc94dffd645",
            "field_orientation":"SW",
            "stadium_type":"retractable",
            "time_zone":"US/Central",
            "location":{
               "lat":"32.747300",
               "lng":"-97.081820"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         },
         "home":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         }
      },
      {
         "id":"b5529e9a-25df-4923-93d7-3cf9dd91e013",
         "status":"unnecessary",
         "coverage":"full",
         "game_number":1,
         "day_night":"N",
         "scheduled":"2023-11-05T00:03:00+00:00",
         "home_team":"d99f919b-1534-4516-8e8a-9cd106c6d8cd",
         "away_team":"25507be1-6a68-4267-bd82-e097d94b359b",
         "ps_round":"WS",
         "ps_game":"7",
         "double_header":false,
         "entry_mode":"STOMP",
         "reference":"748536",
         "venue":{
            "name":"Globe Life Field",
            "market":"Texas",
            "capacity":40000,
            "surface":"turf",
            "address":"734 Stadium Drive",
            "city":"Arlington",
            "state":"TX",
            "zip":"76011",
            "country":"USA",
            "id":"b4372592-9dac-4387-864b-dfc94dffd645",
            "field_orientation":"SW",
            "stadium_type":"retractable",
            "time_zone":"US/Central",
            "location":{
               "lat":"32.747300",
               "lng":"-97.081820"
            }
         },
         "broadcast":{
            "network":"FOX"
         },
         "away":{
            "name":"Diamondbacks",
            "market":"Arizona",
            "abbr":"ARI",
            "id":"25507be1-6a68-4267-bd82-e097d94b359b"
         },
         "home":{
            "name":"Rangers",
            "market":"Texas",
            "abbr":"TEX",
            "id":"d99f919b-1534-4516-8e8a-9cd106c6d8cd"
         }
      }
   ]
}

Update applies to: MLB v7