Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasonal Awards

MLB Seasonal Awards provides a list of all MLB awards for a given season and season type.

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

Update Frequency

TTL / Cache: 12 hours

Data Updates: Award entries are added as they are announced

📘

Retrieving Standings and Rankings

Learn how to display award recipients and enrich season pages with award metadata in our Retrieving Standings and Rankings integration scenario.


Data Points

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

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

REG (Regular Season), PST (Postseason)
yearseasonIntegerYear of a season
Awards
AttributeParent ElementTypeDescription
awarded_time_frequencyawardsStringFrequency at which an award is distributed

ex. annual
awarded_time_periodawardsStringTime period of an award

ex. 2024
descriptionawardsStringDescription of an award

ex. This award is given to the most valuable player in the American League.
effective_dateawardsStringDate of an award's announcement

ex. 2024-11-21
idawardsStringUnique ID of an award

ex. 9c286784-f96c-4c8b-8c3a-3eb132a23b7a
nameawardsStringName of an award

ex. AL Most Valuable Player
typeawardsStringType of award

ex. Player, Coach
Award Recipient
AttributeParent ElementTypeDescription
idawards - recipientsStringUnique player Id of an award recipient

ex. 86f7390e-61bd-4556-8325-a6705c7f693b
levelawards - recipientsStringLevel of an award recipient (could be used to distinguish between an award winner and an award finalist)

ex. winner
nameawards - recipientsStringName of an award recipient

ex. Aaron Judge
positionawards - recipientsStringPosition of an award recipient

ex. CF
Team
AttributeParent ElementTypeDescription
abbrrecipients - teamStringAbbreviation of an award recipient's team

ex. NYY
idrecipients - teamGUIDUnique ID of an award recipient's team

ex. a09ec676-f887-43dc-bbb3-cf4bbaee9a18
marketrecipients - teamStringMarket name of an award recipient's team

ex. New York
namerecipients - teamStringName of an award recipient's team

ex. Yankees

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

Allowed:
string
enum
required
Defaults to REG

Type of season

REG (Regular 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