Soccer API Tech Docs

Search in tech docs

Soccer API Tournament Standings

Standings endpoint serves league tables in overall, home and away formats

Soccer Tournament Standings Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of tournament from Tournament List endpoint

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Call Rate / Interval

Recommended API Call Interval: 3 Request / Hour Daily Max API Call: 288 Request

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
tournamentId	INT	R	{tournamentId}	The id of the tournament.

Response Output

[ { "tournament": { "name": "Champions League", "shortName": "CL", "id": 3 }, "stage": { "name": "Group A", "shortName": "A", "id": 37171 }, "round": { "name": "Round 6", "shortName": "W6", "id": 6 }, "standings": { "overall": [ { "team": { "name": "Borussia Dortmund", "shortName": "BVB", "mediumName": "BVB Dortmund", "id": 719 }, "positionStatus": { "name": "Next Round", "id": 20 }, "scored": 10, "against": 2, "position": 1, "delta": -1, "played": 6, "won": 4, "draw": 1, "lost": 1, "points": 13 }, { "team": { "name": "Atletico Madrid", "shortName": "ATL", "mediumName": "Atl. Madrid", "id": 408 }, "positionStatus": { "name": "Next Round", "id": 20 }, "scored": 9, "against": 6, "position": 2, "delta": 1, "played": 6, "won": 4, "draw": 1, "lost": 1, "points": 13 }, { "team": { "name": "Club Brugge", "shortName": "CBKV", "mediumName": "C. Brugge", "id": 2073 }, "positionStatus": { "name": "UEFA Europa League", "id": 2 }, "scored": 6, "against": 5, "position": 3, "delta": 0, "played": 6, "won": 1, "draw": 3, "lost": 2, "points": 6 }, { "team": { "name": "Monaco", "shortName": "ASM", "mediumName": "Monaco", "id": 7961 }, "scored": 2, "against": 14, "position": 4, "delta": 0, "played": 6, "won": 0, "draw": 1, "lost": 5, "points": 1 } ], "home": [ { "team": { "name": "Atletico Madrid", "shortName": "ATL", "mediumName": "Atl. Madrid", "id": 408 }, "scored": 7, "against": 1, "position": 1, "delta": 0, "played": 3, "won": 3, "draw": 0, "lost": 0, "points": 9 }, { "team": { "name": "Borussia Dortmund", "shortName": "BVB", "mediumName": "BVB Dortmund", "id": 719 }, "scored": 7, "against": 0, "position": 2, "delta": 0, "played": 3, "won": 2, "draw": 1, "lost": 0, "points": 7 }, { "team": { "name": "Club Brugge", "shortName": "CBKV", "mediumName": "C. Brugge", "id": 2073 }, "scored": 1, "against": 2, "position": 3, "delta": 0, "played": 3, "won": 0, "draw": 2, "lost": 1, "points": 2 }, { "team": { "name": "Monaco", "shortName": "ASM", "mediumName": "Monaco", "id": 7961 }, "scored": 1, "against": 8, "position": 4, "delta": 0, "played": 3, "won": 0, "draw": 0, "lost": 3, "points": 0 } ], "away": [ { "team": { "name": "Borussia Dortmund", "shortName": "BVB", "mediumName": "BVB Dortmund", "id": 719 }, "scored": 3, "against": 2, "position": 1, "delta": -2, "played": 3, "won": 2, "draw": 0, "lost": 1, "points": 6 }, { "team": { "name": "Club Brugge", "shortName": "CBKV", "mediumName": "C. Brugge", "id": 2073 }, "scored": 5, "against": 3, "position": 2, "delta": 1, "played": 3, "won": 1, "draw": 1, "lost": 1, "points": 4 }, { "team": { "name": "Atletico Madrid", "shortName": "ATL", "mediumName": "Atl. Madrid", "id": 408 }, "scored": 2, "against": 5, "position": 3, "delta": 1, "played": 3, "won": 1, "draw": 1, "lost": 1, "points": 4 }, { "team": { "name": "Monaco", "shortName": "ASM", "mediumName": "Monaco", "id": 7961 }, "scored": 1, "against": 6, "position": 4, "delta": 0, "played": 3, "won": 0, "draw": 1, "lost": 2, "points": 1 } ] }, "name": "Group A - League Table", "showWPG": false, "showGB": false, "id": 6869 } ]

sample - 1: UEFA Champions League

[ { "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 }, "round": { "name": "Round 35", "shortName": "W35", "id": 35 }, "standings": { "overall": [ { "team": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "positionStatus": { "name": "Champions League", "id": 1 }, "scored": 79, "against": 20, "position": 1, "delta": 0, "played": 35, "won": 27, "draw": 7, "lost": 1, "points": 88 }, { "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "positionStatus": { "name": "Champions League", "id": 1 }, "scored": 87, "against": 22, "position": 2, "delta": 0, "played": 34, "won": 28, "draw": 2, "lost": 4, "points": 86 }, { "team": { "name": "Tottenham Hotspur", "shortName": "TOT", "mediumName": "Tottenham", "id": 373 }, "positionStatus": { "name": "Champions League", "id": 1 }, "scored": 65, "against": 35, "position": 3, "delta": 0, "played": 35, "won": 23, "draw": 1, "lost": 11, "points": 70 }, { "team": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "positionStatus": { "name": "Champions League", "id": 1 }, "scored": 59, "against": 38, "position": 4, "delta": -1, "played": 35, "won": 20, "draw": 7, "lost": 8, "points": 67 }, { "team": { "name": "Arsenal", "shortName": "ARS", "mediumName": "Arsenal", "id": 157 }, "positionStatus": { "name": "UEFA Europa League", "id": 2 }, "scored": 68, "against": 43, "position": 5, "delta": 1, "played": 34, "won": 20, "draw": 6, "lost": 8, "points": 66 }, { "team": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "positionStatus": { "name": "UEFA Europa League Qualification", "id": 14 }, "scored": 63, "against": 48, "position": 6, "delta": 0, "played": 34, "won": 19, "draw": 7, "lost": 8, "points": 64 }, { "team": { "name": "Watford", "shortName": "WAT", "mediumName": "Watford", "id": 378 }, "scored": 50, "against": 50, "position": 7, "delta": -3, "played": 35, "won": 14, "draw": 8, "lost": 13, "points": 50 }, { "team": { "name": "Everton", "shortName": "EVE", "mediumName": "Everton", "id": 218 }, "scored": 50, "against": 44, "position": 8, "delta": -1, "played": 35, "won": 14, "draw": 7, "lost": 14, "points": 49 }, { "team": { "name": "Leicester City", "shortName": "LEIC", "mediumName": "Leicester", "id": 260 }, "scored": 48, "against": 47, "position": 9, "delta": 2, "played": 35, "won": 14, "draw": 6, "lost": 15, "points": 48 }, { "team": { "name": "Wolverhampton", "shortName": "WOL", "mediumName": "Wolves", "id": 388 }, "scored": 41, "against": 42, "position": 10, "delta": 2, "played": 34, "won": 13, "draw": 9, "lost": 12, "points": 48 }, { "team": { "name": "West Ham United", "shortName": "WHU", "mediumName": "West Ham", "id": 381 }, "scored": 44, "against": 54, "position": 11, "delta": 0, "played": 35, "won": 12, "draw": 7, "lost": 16, "points": 43 }, { "team": { "name": "Crystal Palace", "shortName": "CPFC", "mediumName": "Cry.Palace", "id": 211 }, "scored": 43, "against": 48, "position": 12, "delta": -1, "played": 35, "won": 12, "draw": 6, "lost": 17, "points": 42 }, { "team": { "name": "Newcastle United", "shortName": "NUFC", "mediumName": "Newcastle Utd.", "id": 277 }, "scored": 35, "against": 44, "position": 13, "delta": -2, "played": 35, "won": 11, "draw": 8, "lost": 16, "points": 41 }, { "team": { "name": "AFC Bournemouth", "shortName": "BOUR", "mediumName": "AFC Bournemouth", "id": 176 }, "scored": 49, "against": 62, "position": 14, "delta": 2, "played": 35, "won": 12, "draw": 5, "lost": 18, "points": 41 }, { "team": { "name": "Burnley", "shortName": "BURN", "mediumName": "Burnley", "id": 187 }, "scored": 44, "against": 62, "position": 15, "delta": 1, "played": 35, "won": 11, "draw": 7, "lost": 17, "points": 40 }, { "team": { "name": "Southampton", "shortName": "SOT", "mediumName": "Southampton", "id": 355 }, "scored": 41, "against": 58, "position": 16, "delta": 0, "played": 35, "won": 9, "draw": 10, "lost": 16, "points": 37 }, { "team": { "name": "Brighton", "shortName": "BHA", "mediumName": "Brighton", "id": 182 }, "scored": 32, "against": 54, "position": 17, "delta": 0, "played": 35, "won": 9, "draw": 7, "lost": 19, "points": 34 }, { "team": { "name": "Cardiff", "shortName": "CAR", "mediumName": "Cardiff City", "id": 194 }, "positionStatus": { "name": "Relegation", "id": 3 }, "scored": 30, "against": 65, "position": 18, "delta": 0, "played": 35, "won": 9, "draw": 4, "lost": 22, "points": 31 }, { "team": { "name": "Fulham", "shortName": "FUL", "mediumName": "Fulham", "id": 226 }, "positionStatus": { "name": "Relegation", "id": 3 }, "scored": 33, "against": 76, "position": 19, "delta": 0, "played": 35, "won": 6, "draw": 5, "lost": 24, "points": 23 }, { "team": { "name": "Huddersfield", "shortName": "HUD", "mediumName": "Huddersfield", "id": 246 }, "positionStatus": { "name": "Relegation", "id": 3 }, "scored": 20, "against": 69, "position": 20, "delta": 0, "played": 35, "won": 3, "draw": 5, "lost": 27, "points": 14 }, "name": "2018/2019 League Table", "showWPG": false, "showGB": false, "id": 6541 } ]

sample - 2: English Premier League

Response Output Definitions

list

Data

Type

Example

Description

name

STR

English Premier League Standings

The name of the table.

ShowWPG

BLN

true

Decides to show or not WinningPercentage in the table

ShowGB

BLN

true

Decides to show or not GamesBehind in the table

INT

6441

The id of the table.

tournament

Data	Type	Example	Description
name	STR	English Premier League	The name of the tournament
shortName	STR	EPL	The short name of the tournament
id	INT	4	The id of the tournament

stage

Data	Type	Example	Description
name	STR	2018/2019 Season	The name of the stage
shortName	STR	18/19	The short name of the stage
id	INT	37295	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 1	The name of the round
name	STR	W1	The short name of the round
id	INT	1	The id of round

groupingField

Data	Type	Example	Description
name	STR	Conference	The name of the grouping field
shortName	STR	Conf	The short name of the grouping field
id	INT	2	The id of the grouping field

standings

overall/home/away

Data

Type

Example

Description

position

INT

The position of the team in the table

delta

INT

Compare the position to previous week

played

INT

Total match count of the team

won

INT

Total won count of the team

draw

INT

Total draw count of the team

lost

INT

Total lost count of the team

scored

INT

Total goal scored count of the team

against

INT

Total goal against count of the team

average

INT

Goal average of the team

points

INT

Total points of the team

team

Data	Type	Example	Description
name	STR	Manchester City	The full name of the team
shortName	STR	MCFC	The short name of the team
mediumName	STR	Man. City	The medium name of the team
isNational	BLN	false	Determines the team is a club team or a national team
id	INT	269	The id of the team

positionStatus

Data	Type	Example	Description
name	STR	Champions League	Provides info about placements for local or international cups
id	INT	1	The id of the positionStatus

groupingValue

Data	Type	Example	Description
name	STR	East	The name of grouping value for the team
parentId	INT	2	The id of the parent grouping value for the team
id	INT	1	The id of the grouping value for the team

Soccer API Tech Docs

Tech Docs Index

Documentation+

Widgets+

Lookups+

Global API+

Soccer API+

Basketball API+

Football API+

Baseball API+

Ice Hockey API+

Volleyball API+

Handball API+

Table Tennis API+

Tennis API+