Soccer API Tech Docs

Question & Answers

Soccer API Tournament Info

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

Soccer 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/2019", "shortName": "18/19", "id": 9793 }, "country": { "name": "International", "shortName": "", "id": 14 }, "participantType": { "name": "Club", "id": 1 }, "stages": [ { "stages": [ { "stages": [ { "tbr": { "extraTime": true, "penalties": true }, "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "Pre-Qualification - Semi Final", "shortName": "PQ SF", "id": 37188 }, { "tbr": { "extraTime": true, "penalties": true }, "rounds": [ { "name": "Single Game", "shortName": "SG", "active": true, "id": 209 } ], "name": "Pre-Qualification - Final", "shortName": "QRF", "id": 37189 } ], "name": "Qualifying Round", "shortName": "PQT", "id": 37187 }, { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "active": true, "id": 200 } ], "name": "1st Qualification round", "shortName": "1st QR", "id": 37166 }, { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "active": true, "id": 200 } ], "name": "2nd Qualification round", "shortName": "2nd QR", "id": 37167 }, { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "active": true, "id": 200 } ], "name": "3rd Qualification round", "shortName": "3PT", "id": 37168 }, { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "active": true, "id": 200 } ], "name": "Playoff", "shortName": "POFF", "id": 37169 } ], "name": "Qualifying Round", "shortName": "QT", "id": 37165 }, { "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", "active": true, "id": 6 } ], "name": "Group A", "shortName": "A", "id": 37171 } ], "name": "Groups", "shortName": "GRP", "id": 37170 }, { "stages": [ { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "active": true, "id": 200 } ], "name": "2nd Round", "shortName": "2. T", "id": 37180 }, { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "rounds": [ { "name": "Game 1", "shortName": "M1", "active": true, "id": 199 }, { "name": "Game 2", "shortName": "M2", "id": 200 } ], "name": "Quarter-Final", "shortName": "QF", "active": true, "id": 37181 }, { "tbr": { "awayGoals": true, "extraTime": true, "penalties": true }, "name": "Semi Final", "shortName": "SF", "id": 37182 }, { "tbr": { "extraTime": true, "penalties": true }, "name": "Final", "shortName": "F", "id": 37183 } ], "name": "Final", "shortName": "F", "id": 37179 } ], "name": "Champions League", "shortName": "CL", "mediumName": "", "globalName": "Champions League", "localName": "", "isOfficial": true, "id": 3 }

sample - 1: UEFA Champions League

{ "season": { "name": "2018/2019", "shortName": "18/19", "id": 9839 }, "country": { "name": "England", "shortName": "ENG", "id": 2 }, "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", "id": 17 }, { "name": "Round 18", "shortName": "W18", "id": 18 }, { "name": "Round 19", "shortName": "W19", "id": 19 }, { "name": "Round 20", "shortName": "W20", "id": 20 }, { "name": "Round 21", "shortName": "W21", "id": 21 }, { "name": "Round 22", "shortName": "W22", "id": 22 }, { "name": "Round 23", "shortName": "W23", "id": 23 }, { "name": "Round 24", "shortName": "W24", "id": 24 }, { "name": "Round 25", "shortName": "W25", "id": 25 }, { "name": "Round 26", "shortName": "W26", "id": 26 }, { "name": "Round 27", "shortName": "W27", "id": 27 }, { "name": "Round 28", "shortName": "W28", "id": 28 }, { "name": "Round 29", "shortName": "W29", "id": 29 }, { "name": "Round 30", "shortName": "W30", "id": 30 }, { "name": "Round 31", "shortName": "W31", "id": 31 }, { "name": "Round 32", "shortName": "W32", "id": 32 }, { "name": "Round 33", "shortName": "W33", "id": 33 }, { "name": "Round 34", "shortName": "W34", "id": 34 }, { "name": "Round 35", "shortName": "W35", "active": true, "id": 35 }, { "name": "Round 36", "shortName": "W36", "id": 36 }, { "name": "Round 37", "shortName": "W37", "id": 37 }, { "name": "Round 38", "shortName": "W38", "id": 38 } ], "name": "2018/2019 Season", "shortName": "18/19", "active": true, "id": 37295 } ], "name": "English Premier League", "shortName": "EPL", "mediumName": "", "globalName": "English Premier League", "localName": "", "isOfficial": true, "isNational": true, "id": 2 }

sample - 2: English Premier League

Response Output Definitions

tournament

Data

Type

Example

Description

name

STR

Turkish Super League

The name of the tournament.

shortName

STR

TSL

The short name of the tournament.

mediumName

STR

The medium name of the tournament.

globalName

STR

Turkish Super League

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/2019	The name of the season
shortName	STR	18/19	The short name of the season
id	INT	9875	The id of the country

country

Data	Type	Example	Description
name	STR	Turkey	The name of the country
shortName	STR	TR	The short name of the country
id	INT	1	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

Data

Type

Example

Description

name

STR

2018/2019 Season

The name of the stage

shortName

STR

18/19

The short name of the stage

active

BLN

true

Determines the stage is active or not

roundless

BLN

true

Determines the stage is roundless or not

INT

37791

The id of the stage

rounds

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

tbr

Data	Type	Example	Description
awayGoals	BLN	true	Determines the Away Goals tie break rule is used or not for that stage
extraTime	BLN	true	Determines the Extra Time tie break rule is used or not for that stage
penalties	BLN	true	Determines the Penalties tie break rule is used or not for that stage

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

Soccer API Tournament Info

Soccer Tournament Info Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

tournament

season

country

participantType

stages

rounds

tbr