Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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

10s Time To Live / Cache


Data Points

Groups, Rounds, Seasons, & Stages
AttributeParent ElementTypeDescription
idseason_standing - groups - groupStringUnique ID for a season's group

ex. sr:league:80253 (UEFA Euro 2024, Group D)
liveseason_standing - groups - groupBooleanSignifies standings are based on live scores when true
nameseason_standing - groups - groupStringName of a season's group

ex. UEFA Euro 2024, Group D
group_nameseason_standing - groups - groupStringAbbreviated name of a season's group

ex. D
parent_group_idseason_standing - groups - groupStringUnique ID for a parent of a season's group. For example, Eastern Conference (sr:league:71197) could be a child of MLS (sr:league:71197)

ex. sr:league:71197
end_dateseason_standing - groups - group - stageDateEnd date of a season's stage

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

ex. regular season, preliminary_round, qualification
start_dateseason_standing - groups - group - stageDateStart date of a season's stage

ex. 2023-08-11
typeseason_standing - groups - group - stageStringType of a season's stage

cup, league
yearseason_standing - groups - group - stageStringYear of a season's stage

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

ex. LIV (Liverpool FC)
age_groupstanding - competitorStringAge group of a competitor, when applicable

ex. U23
countrystanding - competitorStringCountry of a competitor

ex. England
country_codestanding - competitorStringCountry code of a competitor

ex. ENG (England)
formstanding - competitorStringForm standings for a team's last 5 matches, with the oldest match listed first.

W = Win, L = Loss, D = Draw

ex. WWLWD
genderstanding - competitorStringGender for a competitor

male, female
idstanding - competitorStringUnique ID for a competitor

ex. sr:competitor:44 (Liverpool FC)
namestanding - competitorStringName for a competitor

ex. Liverpool FC
virtualstanding - competitorBooleanSignifies a competitor is a virtual team when true
Standings

Standings are separated in the following possible categories: total, home, away, first_half_total, first_half_home, first_half_away, second_half_total, second_half_home, second_half_away, best_third

AttributeParent ElementTypeDescription
points_drawseason_standingIntegerNumber of points awarded for a draw in the season standing group
points_lossseason_standingIntegerNumber of points awarded for a loss in the season standing group
points_winseason_standingIntegerNumber of points awarded for a win in the season standing group
tie_break_ruleseason_standingStringTie break rule for the season standing group

ex. In the event that two (or more) teams have an equal number of points, the following rules break the tie: 1. Goal difference 2. Goals scored
typeseason_standingStringCategory of the season standing group

total, home, away, first_half_total, first_half_home, first_half_away, second_half_total, second_half_home, second_half_away, best_third
changegroup - stage - standingIntegerChange in a team's standing rank from the previous week

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

ex. Champions League or Relegation
drawgroup - stage - standingIntegerNumber of ties for a team in the season standing group
goals_againstgroup - stage - standingIntegerNumber of goals against for a team in the season standing group
goals_diffgroup - stage - standingIntegerGoal difference for a team in the season standing group

ex. 42 or -3
goals_forgroup - stage - standingIntegerNumber of goals scored for a team in the season standing group
lossgroup - stage - standingIntegerNumber of losses for a team in the season standing group
playedgroup - stage - standingIntegerNumber of matches played for a team in the season standing group
pointsgroup - stage - standingIntegerNumber of points for a team in the season standing group
points_per_gamegroup - stage - standingDoubleAverage points per game for a team in the season standing group

ex. 1.95
rankgroup - stage - standingIntegerTeam rank in the season standing group
roundgroup - stage - standingIntegerNumber of rounds in the season standing group
wingroup - stage - standingIntegerNumber of wins for a team in the season standing group
textgroup - stage - standing - commentStringSupplementary info for a team's standings entry

ex. 6 points deducted due to decision by the Federation
Path Params
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

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), th (Thai), tr (Turkish), 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.

string
required
Defaults to sr:season:130281

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

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