Basketball API Tech Docs

Search in tech docs

Basketball API Tournament Info

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

Basketball 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": 1543 }, "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "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 25", "shortName": "W25", "id": 25 }, { "name": "Round 26", "shortName": "W26", "active": true, "id": 26 } ], "name": "Regular Season", "shortName": "NS", "roundless": true, "id": 16803 }, { "stages": [ { "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "id": 200 }, { "name": "Game 3", "shortName": "M3", "id": 201 }, { "name": "Game 4", "shortName": "M4", "id": 202 }, { "name": "Game 5", "shortName": "M5", "active": true, "id": 203 } ], "name": "East Conference Quarter Finals", "shortName": "ECQF", "id": 16805 }, { "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "id": 200 }, { "name": "Game 3", "shortName": "M3", "id": 201 }, { "name": "Game 4", "shortName": "M4", "id": 202 }, { "name": "Game 5", "shortName": "M5", "active": true, "id": 203 }, { "name": "Game 6", "shortName": "M6", "id": 204 } ], "name": "East Conference Semi Finals", "shortName": "ECSF", "active": true, "id": 16806 }, { "name": "East Conference Finals", "shortName": "ECF", "id": 16807 } ], "name": "Eastern Conference Playoffs", "shortName": "ECPO", "id": 16804 }, { "stages": [ { "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "id": 200 }, { "name": "Game 3", "shortName": "M3", "id": 201 }, { "name": "Game 4", "shortName": "M4", "id": 202 }, { "name": "Game 5", "shortName": "M5", "id": 203 }, { "name": "Game 6", "shortName": "M6", "id": 204 }, { "name": "Game 7", "shortName": "M7", "active": true, "id": 205 } ], "name": "West Conference Quarter Finals", "shortName": "WCQF", "id": 16809 }, { "rounds": [ { "name": "Game 1", "shortName": "M1", "id": 199 }, { "name": "Game 2", "shortName": "M2", "id": 200 }, { "name": "Game 3", "shortName": "M3", "id": 201 }, { "name": "Game 4", "shortName": "M4", "id": 202 }, { "name": "Game 5", "shortName": "M5", "active": true, "id": 203 }, { "name": "Game 6", "shortName": "M6", "id": 204 } ], "name": "West Conference Semi Finals", "shortName": "WCSF", "id": 16810 }, { "name": "West Conference Finals", "shortName": "WCF", "id": 16811 } ], "name": "Western Conference Play-offs", "shortName": "WCPO", "id": 16808 }, { "name": "League Finals", "shortName": "LF", "id": 16812 } ], "name": "NBA", "shortName": "NBA", "globalName": "NBA", "localName": "", "id": 9 }

Response Output Definitions

tournament

Data

Type

Example

Description

name

STR

Turkish Basketball Super League

The name of the tournament.

shortName

STR

TBSL

The short name of the tournament.

mediumName

STR

The medium name of the tournament.

globalName

STR

Turkish Basketball 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	1583	The id of the season

country

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

Stage is active?

roundless

BLN

true

Determines the round/stage is roundless or not

INT

16779

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	Round is active?
id	INT	1	The id of the round

tbr (Tie Break Rules)

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

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

Basketball API Tournament Info

Basketball 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

tbr (Tie Break Rules)