Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Series Schedule

MLB Series Schedule provides postseason participant information as well as the date, time, location, and other event details for every match-up taking place for the entire postseason.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache:

  • 5 minutes for series with active games (games in non-closed status)
  • 12 hours for series without active games

Data Updates:

  • Schedule info updates in realtime as changes are made.
  • The initial playoff schedule (with TBD matchups) will be available in August.
📘

Tracking MLB Playoffs

Learn how to retrieve detailed team and player statistics for a specific postseason series in our Tracking MLB Playoffs integration scenario.


Data Points

Boxscore
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
Game
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
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

STOMP, LDE
gameday_typegameStringCoverage level of a game defined as Premium, Enhanced, or Regular

P - Premium
Pitch tracking, player tracking, and full Statcast product experience

E - Enhanced
Pitch tracking but not full Statcast product experience

Y - Regular
Pitch-by-Pitch resulting but no Statcast product experience

ex. gameday_type="E"
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. See our FAQ for all statuses and their definitions.

scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance
Broadcast
AttributeParent ElementTypeDescription
channelbroadcasts - broadcastStringName of a game's broadcast channel

ex. 213
localebroadcasts - broadcastStringSignifies the locale of a broadcast

ex. Home, Away, National
networkbroadcasts - broadcastStringName of a game's broadcast network

ex. MLB Network, NBCS-BA, ESPN
typebroadcasts - broadcastStringType of broadcast

ex. TV, Internet
League
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
Series
AttributeParent ElementTypeDescription
best_ofseriesIntegerNumber of games in a series
nameseries - participantStringName of a series participant

ex. Astros
idseriesGUIDUnique ID of a series

ex. 05c860de-4ad4-4e21-8d24-d669cb7a498c
ps_gamegameIntegerGame number in a series
ps_roundgameStringName of a series

ex. ALDS
roundseriesStringAbbreviated name of a series

ex. WS or ALDS2
recordseries - participantIntegerNumber of wins for a participant in a series
start_dateseriesDateStart date of a series

ex. 2022-10-26
statusseriesStringStatus of a series

ex. scheduled
titleseriesStringTitle of a series

ex. NL Wildcard - TBD vs STL or World Series - ATL vs HOU
Teams
AttributeParent ElementTypeDescription
abbrteamStringAbbreviation of a team

ex. TB (Tampa Bay)
idteamGUIDUnique ID of a team

ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team

ex. Tampa Bay
nameteamStringTeam name

ex. Rays
seedteamIntegerSeed number for a team
Venue
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

Path Params
string
enum
required
Defaults to trial

The access level of your API key

production (Production), trial (Trial),
tracking (Statcast Production), trial-tracking (Statcast Trial)

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
enum
required
Defaults to 2025

Year of a season in YYYY format

string
enum
required
Defaults to PST

Type of season

PST (Postseason)

Allowed:
string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json