Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasons

MLB Seasons provides a complete list of historical season information available in the API.

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

Update Frequency

TTL / Cache: 4 hours

Data Updates: New seasons appear as they are added to the database.

  • Season statuses update during the day of a status change.
📘

Pulling Schedules

Learn how to use the Seasons feed to confirm available season years and types before requesting schedule or statistics data in our Pulling Schedules integration scenario.


Data Points

League & Seasons
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
idseasonGUIDUnique ID of a season

ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1
typeseasonStringType of season

PRE(Spring Training), REG(Regular Season), PST(Postseason), AST(All-Star Game)
yearseasonIntegerYear of a season
start_dateseasonDateStart date of a season

ex. 2022-03-29
end_dateseasonDateEnd date of a season

ex. 2022-10-05
statusseasonStringStatus of a season

ex. inprogress, closed
codeseason - typeStringCode of a season type

ex. REG (Regular), PRE (Preseason), PST (Postseason), AST (All-Star)
nameseason - typeStringName of a season type

ex. Regular season, Pre-season, Post-season, All Star Game

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 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