Football API Tech Docs

Search in tech docs

Football API Tournament Info

Provides the information about tournaments. Names, Season, Stage(s).

Football Tournament Info Request URL

GET

References / Dependencies

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

Call Rate / Interval

Recommended API Call Interval: 1 Request / Day Daily Max API Call: 4 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

{ "season": { "name": "2018", "shortName": "18", "id": 115 }, "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "participantType": { "name": "Club", "id": 1 }, "stages": [ { "rounds": [ { "name": "Round 1", "shortName": "W1", "id": 1 }, { "name": "Round 2", "shortName": "W2", "id": 2 }, { "name": "Round 3", "shortName": "W3", "id": 3 }, { "name": "Round 4", "shortName": "W4", "id": 4 }, { "name": "Round 5", "shortName": "W5", "id": 5 }, { "name": "Round 6", "shortName": "W6", "id": 6 }, { "name": "Round 7", "shortName": "W7", "id": 7 }, { "name": "Round 8", "shortName": "W8", "id": 8 }, { "name": "Round 9", "shortName": "W9", "id": 9 }, { "name": "Round 10", "shortName": "W10", "id": 10 }, { "name": "Round 11", "shortName": "W11", "id": 11 }, { "name": "Round 12", "shortName": "W12", "id": 12 }, { "name": "Round 13", "shortName": "W13", "id": 13 }, { "name": "Round 14", "shortName": "W14", "id": 14 }, { "name": "Round 15", "shortName": "W15", "id": 15 }, { "name": "Round 16", "shortName": "W16", "id": 16 }, { "name": "Round 17", "shortName": "W17", "active": true, "id": 17 } ], "name": "Regular Season", "shortName": "NS", "id": 717 }, { "stages": [ { "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "Wildcard Round", "shortName": "WC", "id": 719 }, { "stages": [ { "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "AFC Divisional Play-Offs", "shortName": "ACPO", "id": 721 }, { "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "NFC Divisional Play-Offs", "shortName": "NCPO", "id": 722 } ], "name": "Divisional Play-offs", "shortName": "CPO", "id": 720 }, { "stages": [ { "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "AFC Championship", "shortName": "ACF", "id": 724 }, { "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "NFC Championship", "shortName": "NCF", "id": 725 } ], "name": "Conference Finals", "shortName": "CF", "id": 723 }, { "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "Super Bowl", "shortName": "SB", "active": true, "id": 726 } ], "name": "Playoffs", "shortName": "PO", "id": 718 } ], "name": "National Football League", "shortName": "NFL", "globalName": "", "localName": "", "id": 1 }

sample - 1: NFL

Response Output Definitions

tournament

Data

Type

Example

Description

name

STR

National Football League

The name of the tournament.

shortName

STR

NFL

The short name of the tournament.

globalName

STR

The global name of the tournament.

localName

STR

The local name of the tournament.

isOfficial

BLN

true

Determines that the tournament is official or unofficial.

isNational

BLN

true

Determines that national team join or not into the tournament.

INT

The id of the tournament.

season

Data	Type	Example	Description
name	STR	2018	The name of the season
shortName	STR	18	The short name of the season
id	INT	115	The id of the season

country

Data	Type	Example	Description
name	STR	U.S.A	The name of the country
shortName	STR	USA	The short name of the country
id	INT	18	The id of the country

participantType

Data	Type	Example	Description
name	STR	Club	The participant type of the tournament. Determines that the club or national teams can participate
id	INT	1	The id of the participant type. 1 = Club, 2 = National

stages

stage

Data

Type

Example

Description

name

STR

Regular Season

The name of the stage

shortName

STR

The short name of the stage

active

STR

true

Determines the stage is active or not

roundless

BLN

true

Determines the stage is roundless or not

INT

717

The id of the stage

rounds

round

Data	Type	Example	Description
name	STR	Round 1	The name of the round
shortName	STR	W1	The short name of the round
active	STR	true	Determines the round is active or not
id	INT	1	The id of the round

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+

Football API Tournament Info

Football Tournament Info Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

tournament

season

country

participantType

stages

stage

rounds

round