Coverage MatrixDocumentationRelease LogLog In

League Schedule

MLB League Schedule provides complete schedule information for a given season, including venue and broadcast info.


Update Frequency

TTL / Cache: 480 seconds

Data Updates: As Necessary

Data Points

AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
abbrawayStringAbbreviation of the away team
ex. MIN (Minnesota)
idawayGUIDUnique ID of the away team
ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
marketawayStringMarket name of the away team
ex. Colorado
nameawayStringTeam name of the away team
ex. Rockies
durationgameStringDuration of a game in hours and minutes
ex. 3:18
abbrhomeStringAbbreviation of the home team
ex. CLE (Cleveland)
idhomeGUIDUnique ID of the home team
ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
markethomeStringMarket name of the home team
ex. Cleveland
namehomeStringTeam name of the home team
ex. Guardians
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team
ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
cablebroadcastStringName of the game's broadcast cable station
internetbroadcastStringName of the game's internet stream
networkbroadcastStringName of the game's broadcast network
ex. MLB Network
radiobroadcastStringName of the game's broadcast radio station
satellitebroadcastStringName of the game's broadcast satellite station
coveragegameStringCoverage level of a game
full, boxscore
double_headergameBooleanSignifies whether a game is part of a double header
day_nightgameStringSignifies a day or night game
D, N
entry_modegameStringSignifies the type of data entry
home_teamgameGUIDUnique ID of the home team
ex. ef64da7f-cfaf-4300-87b0-9313386b977c
idgameGUIDUnique ID of the game
ex. 1b554f5e-d8b7-4268-95da-2f4191015c84
game_numbergameIntegerNumber of the game
parent_idgameGUIDStandard parent ID of a game or series. Use this ID to group events (like the World Series or All-Star Game) across seasons.
ex. 34e4cbbe-0086-4fad-bb08-840cbcfcabf0 (All-Star Game)
-rescheduled_fromdateTimeOriginal start date/time of a rescheduled game
reasonrescheduled_fromStringReason for a rescheduled game
ex. postponed, suspended
referencegameStringUnique MLBAM ID of a game
scheduledgamedateTimeScheduled date and time of a game
ex. 2022-09-25T20:10:00+00:00
tbdgameBooleanSignifies the game start time is to be determined. Placeholder start time is 08:00:00+00:00
split_squadgameBooleanSignifies a Spring Training split squad game
statusgameStringThe status of a game
scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league
ex. MLB
idleagueGUIDUnique ID of a league
ex. 2fa448bc-fc17-4d3d-be03-e60e080fdc26
nameleagueStringName of a league
ex. Major League Baseball
idseason-scheduleGUIDUnique ID of a season
ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1
typeseason-scheduleStringType of season
PRE(Spring Training), REG(Regular Season), PST(Postseason), AST(All-Star Game)
yearseason-scheduleIntegerYear of a season
AttributeParent ElementTypeDescription
ps_gamegameIntegerGame number in a series
ps_roundgameStringName of a series
ex. ALDS
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 1000 Vin Scully Avenue
capacityvenueStringCapacity of a venue
ex. 56000
cityvenueStringCity of a venue
ex. Los Angeles
countryvenueStringCountry of a venue
ex. USA
field_orientationvenueStringField orientation of a venue
ex. NE
idvenueGUIDUnique ID of a venue
ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f
latlocationDecimalLatitude of a venue
ex. 34.0745409
lnglocationDecimalLongitude of a venue
ex. -118.2408881
marketvenueStringMarket of a venue
ex. Los Angeles
namevenueStringName of a venue
ex. Dodger Stadium
stadium_typevenueStringType of a venue
ex. outdoor
statevenueStringState of a venue
ex. CA
surfacevenueStringSurface type of a venue
ex. grass
time_zonevenueStringTime zone of a venue
ex. US/Central
zipvenueIntegerZIP code of a venue
ex. 90012
Click Try It! to start a request and see the response here!