Standings represent the rankings of Teams in the different Leagues they participate in. Responses of the Standings endpoint can be returned in two formats, depending on the League setup. For ‘normal’ Leagues the response format is different compared to Cups.
If you have Cups and ‘normal’ Leagues in your plan, make sure you check out the response properly.
Live Standings represent the rankings of Teams in the different Leagues they participate in real-time. So if a Game is currently being played, the Live Standing returns the correct Live Standing based
GET LIVE StandingsEndpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Available parameters
group_id
One id of a group can be added to filter the tables. Can be used by adding &group_id= etc to your request url.
Note for cups the group_id parameter is required.
No includes available for this endpoint.
Field
Description
position
The actual position in the rankings in the stage
team_id
The unique team id of the team in that position in the stage
team_name
The team name in that position in the stage
round_id
The unique id of the current round
round_name
The name of the round
group_id
The unique id of the group, in which the team participates in
group_name
The name of the group, in which the team participates in
overall
The overall results of the team, i.e., the number of games, points and goals
home
The home results of the team, i.e., the number of games, points and goals
away
The away results of the team, i.e., the number of games, points and goals
total
The total points of the team and their goal difference
results
The standing rules of the place the team is in
points
The accumulated number of points the team has
recent_form
The recent form of the team
status
Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.
In case a team got points corrections they can be found here. It will return an array of correction objects per stage. In some occasions a stage proceeds with standings from an earlier stage.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
With this endpoint you are able to retrieve the standings at a given date(time). It will calculate the games played up untill the given date/time and provides a standings result for it.
GET Standings by Season ID and Date(time)Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
No parameters available for this endpoint.
No includes available for this endpoint.
Field
Description
position
The actual position in the rankings in the stage
team_id
The unique team id of the team in that position in the stage
team_name
The team name in that position in the stage
round_id
The unique id of the current round
round_name
The name of the round
group_id
The unique id of the group, in which the team participates in
group_name
The name of the group, in which the team participates in
overall
The overall results of the team, i.e., the number of games, points and goals
home
The home results of the team, i.e., the number of games, points and goals
away
The away results of the team, i.e., the number of games, points and goals
total
The total points of the team and their goal difference
results
The standing rules of the place the team is in
points
The accumulated number of points the team has
recent_form
The recent form of the team
status
Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.
With this endpoint you are able to retreive the standings for a given round. It will calculate the games played up untill the given round id and provide a standings result for it.
GET Standings by Season ID and Round IDEndpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
No parameters available for this endpoint.
No includes available for this endpoint.
Field
Description
position
The actual position in the rankings in the stage
team_id
The unique team id of the team in that position in the stage
team_name
The team name in that position in the stage
round_id
The unique id of the current round
round_name
The name of the round
group_id
The unique id of the group, in which the team participates in
group_name
The name of the group, in which the team participates in
overall
The overall results of the team, i.e., the number of games, points and goals
home
The home results of the team, i.e., the number of games, points and goals
away
The away results of the team, i.e., the number of games, points and goals
total
The total points of the team and their goal difference
results
The standing rules of the place the team is in
points
The accumulated number of points the team has
recent_form
The recent form of the team
status
Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.
GET Standings by Season IDEndpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.
stage_ids
A Comma separated list of stage ids. Can be used by adding &stage_ids= etc. to your request url.
group_ids
A Comma separated list of group ids. Can be used by adding &group_ids= etc. to your request url.
Note that includes on this endpoint must be prefixed by "standings."
team league season round stages
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Season Field Description
Field
Description
id
The unique id of the current stage
name
The name of the stage
league_id
The unique league id the stage belongs to
season_id
The unique id of the current season
round_id
The unique id of the current round
round_name
The name of the round
type
Indicates what kind of type this stage is
stage_id
The unique id of the current stage
stage_name
The name of the stage
Standings Field Description
Field
Description
position
The actual position in the rankings in the stage
team_id
The unique team id of the team in that position in the stage
team_name
The team name in that position in the stage
round_id
The unique id of the current round
round_name
The name of the round
group_id
The unique id of the group, in which the team participates in
group_name
The name of the group, in which the team participates in
overall
The overall results of the team, i.e., the number of games, points and goals
home
The home results of the team, i.e., the number of games, points and goals
away
The away results of the team, i.e., the number of games, points and goals
total
The total points of the team and their goal difference
results
The standing rules of the place the team is in
points
The accumulated number of points the team has
recent_form
The recent form of the team
status
Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.