Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Rankings

MLB Rankings provides league and division rank for each team, including postseason clinching status.

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

Update Frequency

TTL / Cache: 12 hours

Data Updates: Rankings update nightly after all games finish.

  • As the playoffs near, the clinched data point updates about 5 minutes after a game closes.
📘

Retrieving Standings and Rankings

Learn how to use Rankings for lightweight rank and clinch status displays, including postseason qualification context, 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
aliasdivisionStringAlias of a division

ex. C
iddivisionGUIDUnique ID of a division

ex. 95e2d773-d899-4751-b61a-b9463e5aa874
namedivisionStringName of a division

ex. Central
aliasleague-leagueStringAlias of a league

ex. NL
idleague-leagueGUIDUnique ID of a league

ex. fbe91704-36df-4e7c-864a-06d236425999
nameleague-leagueStringName of a league

ex. National League
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
Rankings
AttributeParent ElementTypeDescription
divisionrankIntegerRank number in a division
leaguerankIntegerRank number in a league
clinchedrankStringPostseason clinch status

division, wildcard, playoff_berth, division_homefield, eliminated
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

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 REG

Type of season

REG (Regular Season)

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