Football API Tech Docs

Search in tech docs

Football API Tournament Standings

Standings endpoint generally serves league tables in overall, home and away formats. There are also different type of standings which have division/conference format like Division Standings, Conference Standings.

Football 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": "National Football League", "shortName": "NFL", "id": 1 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 717 }, "round": { "name": "Round 17", "shortName": "W17", "id": 17 }, "standings": { "overall": [ { "team": { "name": "Los Angeles Rams", "shortName": "LAR", "mediumName": "Rams", "id": 31 }, "streakWin": 1, "scored": 527, "against": 384, "wpg": 0.812, "gb": 0, "position": 1, "delta": -1, "played": 16, "won": 13, "draw": 0, "lost": 3, "points": 39 }, { "team": { "name": "New Orleans Saints", "shortName": "NO", "mediumName": "Saints", "id": 26 }, "streakLose": 1, "scored": 504, "against": 353, "wpg": 0.812, "gb": 0, "position": 2, "delta": 1, "played": 16, "won": 13, "draw": 0, "lost": 3, "points": 39 }, { "team": { "name": "Chicago Bears", "shortName": "CHI", "mediumName": "Bears", "id": 14 }, "streakWin": 4, "scored": 421, "against": 283, "wpg": 0.75, "gb": 1, "position": 3, "delta": 0, "played": 16, "won": 12, "draw": 0, "lost": 4, "points": 36 }, { "team": { "name": "Kansas City Chiefs", "shortName": "KC", "mediumName": "Chiefs", "id": 23 }, "streakWin": 1, "scored": 565, "against": 421, "wpg": 0.75, "gb": 1, "position": 4, "delta": 0, "played": 16, "won": 12, "draw": 0, "lost": 4, "points": 36 }, { "team": { "name": "Los Angeles Chargers", "shortName": "LAC", "mediumName": "Chargers", "id": 29 }, "streakWin": 1, "scored": 428, "against": 329, "wpg": 0.75, "gb": 1, "position": 5, "delta": 0, "played": 16, "won": 12, "draw": 0, "lost": 4, "points": 36 }, { "team": { "name": "New England Patriots", "shortName": "NE", "mediumName": "Patriots", "id": 5 }, "streakWin": 2, "scored": 436, "against": 325, "wpg": 0.688, "gb": 2, "position": 6, "delta": 0, "played": 16, "won": 11, "draw": 0, "lost": 5, "points": 33 } ] }, "name": "Divisional Standings", "showWPG": true, "showGB": true, "id": 49 } ]

sample - 1: NFL

Response Output Definitions

list

Data

Type

Example

Description

name

STR

Conference 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

The id of the table.

tournament

Data	Type	Example	Description
name	STR	National Football League	The name of the tournament
shortName	STR	NFL	The short name of the tournament
id	INT	1	The id of the tournament

stage

Data	Type	Example	Description
name	STR	Regular Season	The name of the stage
shortName	STR	NS	The short name of the stage
id	INT	717	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 17	The name of the round
name	STR	W17	The short name of the round
id	INT	17	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	1	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

-1

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

527

Total points scored in matches of the team

against

INT

384

Total points scored against in matches for the team

points

INT

39.00

Total points(calculated from won/lost) of the team

wpg

FLT

0.812

Winning percentage

FLT

0.00

Games behind

streakWin

INT

Win streak count for the team

streakLose

INT

Lose streak count for the team

team

Data	Type	Example	Description
name	STR	Los Angeles Rams	The full name of the team
shortName	STR	LAR	The short name of the team
mediumName	STR	Rams	The medium name of the team
id	INT	31	The id of the team

positionStatus

Data	Type	Example	Description
name	STR	Conference Semi Finals	Provides info about placements for local or international cups
id	INT	2	The id of the positionStatus

groupingValue

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

Football 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+