Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Standings

Global Baseball Season Standings provides detailed standings info for a given season.

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

Update Frequency

TTL / Cache: 10 seconds

Data Updates: post coverage: after games close; live coverage: during play

Recommended polling cadences for every feed are on the Update Frequencies chart of the Global Baseball Integration Guide.

📘

Tracking Standings

Learn how to use the Season Standings feed to pull league tables and read them during and after play in our Tracking Standings integration scenario.


Data Points

Groups
AttributeParent ElementTypeDescription
idseason_standing - groups - groupStringUnique ID for a standings group

ex. sr:league:80913 (American League Central)
liveseason_standing - groups - groupBooleanSignifies standings are based on live scores when true
nameseason_standing - groups - groupStringName of a standings group

ex. American League Central
group_nameseason_standing - groups - groupStringAbbreviated name of a standings group

ex. American League Central
parent_group_idseason_standing - groups - groupStringUnique ID for a parent of a standings group. For example, the National League (sr:league:80919) could be a child of MLB (sr:league:80909)

ex. sr:league:80909
Stages
AttributeParent ElementTypeDescription
end_dateseason_standing - groups - group - stageDateEnd date of a standings stage

ex. 2024-05-19
orderseason_standing - groups - group - stageIntegerOrder of a stage within a season
phaseseason_standing - groups - group - stageStringName of a standings stage

ex. regular season, conference, playoffs

See the enum_phase entry in our Global Baseball OpenAPI spec for a complete list of valid phase enum values
start_dateseason_standing - groups - group - stageDateStart date of a standings stage

ex. 2023-08-11
typeseason_standing - groups - group - stageStringType of a standings stage

cup, league
yearseason_standing - groups - group - stageStringYear of a standings stage

ex. 23/24
Competitor
AttributeParent ElementTypeDescription
abbreviationstanding - competitorStringAbbreviation for a competitor name

ex. LAD (Los Angeles Dodgers)
age_groupstanding - competitorStringAge group of a competitor, when applicable

ex. U23
countrystanding - competitorStringCountry of a competitor

ex. Japan
country_codestanding - competitorStringCountry code of a competitor

ex. JPN (Japan)
genderstanding - competitorStringGender for a competitor

male, female
idstanding - competitorStringUnique ID for a competitor

ex. sr:competitor:3638 (Los Angeles Dodgers)
namestanding - competitorStringName for a competitor

ex. Los Angeles Dodgers
qualifierstanding - competitorStringDesignation of a competitor for a sport event

home, away
virtualstanding - competitorBooleanSignifies a competitor is a virtual team when true. Used for placeholder teams in TBD vs TBD matchups.
Standings
AttributeParent ElementTypeDescription
tie_break_ruleseason_standingStringTie break rule for the season standing group

ex. The MLB overall table is sorted by percentage
typeseason_standingStringCategory of the season standing group

total, home, away, first_help_total, first_half_home, first_half_away, second_half_total, second_half_home, second_half_away
roundseason_standingIntegerNumber of rounds in the season standing group
changegroup - stage - standingIntegerChange in a team's standing rank from the previous week

ex. 2 or -1
current_outcomegroup - standingStringCurrent outcome of a team for the season

ex. Qualification Playoffs or Playoffs
drawgroup - standingIntegerNumber of ties for a team in the season standing group
games_behindgroup - standingFloatNumber of games behind the season standing group leader

*Only available for MLB and MiLB seasons

ex. 2.5
lossgroup - standingIntegerNumber of losses for a team in the season standing group
loss_awaygroup - standingIntegerNumber of away losses for a team in the season standing group
loss_homegroup - standingIntegerNumber of home losses for a team in the season standing group
loss_last_tengroup - standingIntegerNumber of losses in a team's last ten games
playedgroup - standingIntegerNumber of games played for a team in the season standing group
runs_againstgroup - standingIntegerNumber of runs against for a team in the season standing group
runs_forgroup - standingIntegerNumber of runs scored for a team in the season standing group
rankgroup - standingIntegerTeam rank in the season standing group
win_percentagegroup - standingDecimalWinning percentage for a team in the season standing group. Expressed as a whole number with one decimal.

ex. 64.7
winning_percentagegroup - standingDecimalWinning percentage for a team in the season standing group. Expressed with three decimals.

ex. 0.531
wingroup - standingIntegerNumber of wins for a team in the season standing group
win_homegroup - standingIntegerNumber of home wins for a team in the season standing group
win_awaygroup - standingIntegerNumber of away wins for a team in the season standing group
win_last_tengroup - standingIntegerNumber of wins in a team's last ten games
Path Params
string
enum
required
Defaults to baseball

Sport type

baseball, softball

Allowed:
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English), es (Spanish), ja (Japanese), ko (Korean), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

Allowed:
string
required
Defaults to sr:season:128221

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:128221

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Query Params
int32

Standings for a specified round number. If the round number is not specified, the last round is displayed by default.

Example: round=2

boolean

Determines whether standings are based on live scores. If not specified, live standings are returned.

Visit our Coverage Matrix for live standings availability by competition.

Example: live=false (ignore live standings)

Response

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