Competition Rosters
On this documentation page, we show how you can use our football API to get the information about the predefined competitions squads that all teams announce before a big competition starts.
This football API endpoint provides the players for all the teams that have finalised their squads for the given competition. In order to get the squad of a single team you should use the competitions team squad API endpoint. Using the alternative API endpoint will increase the number of requests that you will send to our servers but if will give you more control over the data that you receive from us.
ENDPOINT
A response of a request to this football API lists the 23 to 26 player squads that coaches announce before the start of big international competitions. If your package supports player translations you have the possibility to choose from 30+ languages. The JSON returned is similar to the response provided by the match lineups API endpoint.
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| competition_id | Number | 1 | 362 | The id of the competition in which the teams participate. |
| lang | String | ar | The 2 letter code of the language, if we want the names of the players in another language. These translations are supported by certain packages only. |
RESPONSE
{
"success": true,
"data": {
"competition": {
"id": 362,
"name": "FIFA World Cup",
"is_league": false,
"is_cup": true,
"tier": 0,
"has_groups": true,
"active": true,
"national_teams_only": true
},
"teams": [
{
"team": {
"id": 1456,
"name": "England",
"stadium": "Wembley Stadium",
"country_id": 115,
"logo": "https:\/\/cdn.live-score-api.com\/teams\/dfc056eeaced99c1853905d5cc6a18ff.png"
},
"squad": [
{
"player": {
"id": 512,
"name": "Callum Wilson"
},
"shirt_number": "24",
"position": "FW"
},
{
"player": {
"id": 531,
"name": "Aaron Ramsdale"
},
"shirt_number": "23",
"position": "GK"
},
{
"player": {
"id": 1334,
"name": "Bukayo Saka"
},
"shirt_number": "17",
"position": "FW"
}
]
},
{
"team": {
"id": 1436,
"name": "Iran",
"stadium": "Azadi Stadium",
"country_id": 116,
"logo": "https:\/\/cdn.live-score-api.com\/teams\/32c97ca276ef2542ec9f8c309c5087ec.png"
},
"squad": [
{
"player": {
"id": 965,
"name": "Saman Ghoddos"
},
"shirt_number": "14",
"position": "MF"
},
{
"player": {
"id": 3230,
"name": "Alireza Jahanbakhsh"
},
"shirt_number": "7",
"position": "MF"
},
{
"player": {
"id": 5333,
"name": "Sadegh Moharrami"
},
"shirt_number": "2",
"position": "DF"
}
]
}
]
}
}| Name | Type | Example | Description |
|---|---|---|---|
| competition | object | {} | The information of the competition in which the teams participate in the form of the standard competition response object |
| squad | array | [] | A list with all the players in the squad of the team for that competition only |
| squad.player | obejct | {} | The information of the player in the form of the standard player response object |
| squad.position | string | MF | The position on which the player usually plays. This does not mean that the player cannot temporarily change his position during a competition or a match.. There are 4 options: GK, DF, MF, and FW. |
| squad.shirt_number | number | 18 | The number on the shirt of the player during the competition |
| team | object | {} | The information of the team with the standard competition response object structure |
| teams | array | [] | An array containing all the teams and their squads. |