Soccer API Tech Docs

Search in tech docs

Soccer API Team Squad

Provides the active season squads for teams.

Soccer Team Squad Request URL

GET

References / Dependencies

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

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams 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
teamId	INT	R	{teamId}	The id of the team.
tournamentId	INT	O/R	{tournamentId}	The id of the tournament. Tournament Id is optional for Club Teams. But it is required value for National Teams.

Response Output

[ { "player": { "country": { "name": "Ukraine", "shortName": "UKR", "id": 47 }, "position": { "name": "Goalkeeper", "shortName": "GK", "id": 1 }, "knownName": "Andriy Lunin", "knownNameMedium": "A.Lunin", "knownNameShort": "Lunin", "name": "Andriy", "surName": "Lunin", "middleName": "", "shirtNumber": "13", "age": 25, "id": 189423 }, "tournaments": [ { "tournament": { "name": "Champions League", "shortName": "CL", "id": 3 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish La Liga", "shortName": "SP1", "id": 7 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Copa del Rey", "shortName": "CR", "id": 48 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "FIFA Clubs World Cup", "shortName": "FCWC", "id": 126 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish Super Cup", "shortName": "SSC", "id": 148 }, "season": { "name": "", "shortName": "", "id": 10588 } } ] }, { "player": { "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Antonio Rüdiger", "knownNameMedium": "A.Rüdiger", "knownNameShort": "Rüdiger", "name": "Antonio", "surName": "Rüdiger", "middleName": "", "shirtNumber": "22", "age": 31, "id": 82118 }, "tournaments": [ { "tournament": { "name": "Champions League", "shortName": "CL", "id": 3 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish La Liga", "shortName": "SP1", "id": 7 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Copa del Rey", "shortName": "CR", "id": 48 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "FIFA Clubs World Cup", "shortName": "FCWC", "id": 126 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish Super Cup", "shortName": "SSC", "id": 148 }, "season": { "name": "", "shortName": "", "id": 10588 } } ] }, { "player": { "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Toni Kroos", "knownNameMedium": "T.Kroos", "knownNameShort": "Kroos", "name": "Toni", "surName": "Kroos", "middleName": "", "shirtNumber": "8", "age": 34, "id": 2505 }, "tournaments": [ { "tournament": { "name": "Champions League", "shortName": "CL", "id": 3 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish La Liga", "shortName": "SP1", "id": 7 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Copa del Rey", "shortName": "CR", "id": 48 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "FIFA Clubs World Cup", "shortName": "FCWC", "id": 126 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish Super Cup", "shortName": "SSC", "id": 148 }, "season": { "name": "", "shortName": "", "id": 10588 } } ] }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Vinicius Junior", "knownNameMedium": "Vinicius Jr.", "knownNameShort": "Vinicius Jr.", "name": "Vinicius", "surName": "Paixao de Oliveira Junior", "middleName": "Jose", "shirtNumber": "7", "age": 24, "id": 198987 }, "tournaments": [ { "tournament": { "name": "Champions League", "shortName": "CL", "id": 3 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish La Liga", "shortName": "SP1", "id": 7 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Copa del Rey", "shortName": "CR", "id": 48 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "FIFA Clubs World Cup", "shortName": "FCWC", "id": 126 }, "season": { "name": "", "shortName": "", "id": 10588 } }, { "tournament": { "name": "Spanish Super Cup", "shortName": "SSC", "id": 148 }, "season": { "name": "", "shortName": "", "id": 10588 } } ] } ]

Response Output Definitions

player

Data

Type

Example

Description

INT

33988

The id of the player

knownName

STR

Thibaut Courtois

The known name of the player

knownNameMedium

STR

T.Courtois

The medium known name of the player

knownNameShort

STR

Courtois

The short known name of the player

name

STR

Thibaut

The first name of the player

surName

STR

Courtois

The last name of the player

middleName

STR

Ramos

The middle name of the player

shirtNumber

INT

The shirt number of the player

age

INT

The age of the player

country

Data	Type	Example	Description
name	STR	Spain	The name of the player's country
shortName	STR	ESP	The short name of the player's country
id	INT	3	The id of the player's country

position

Data	Type	Example	Description
name	STR	Goalkeeper	The name of the position
shortName	STR	GK	The short name of the position
id	INT	1	The id of the position

tournaments

tournament

Data	Type	Example	Description
name	STR	Champions League	The name of the tournament that player played
shortName	STR	CL	The short name of the tournament that player played
id	INT	3	The id of the tournament that player played

season

Data	Type	Example	Description
name	STR	2018/2019	The name of the season for the tournament that player played
shortName	STR	18/19	The short name of the season for the tournament that player played
id	INT	9793	The id of the season for the tournament that player played

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+