Team
Overview
You use the Team resource to access base information about that very team, it’s squad, the
running competitions it is participating this season or you might be interested in it’s latest
matches.
Enough said, see the entire beauty of the Team resource resource below.
curl -XGET 'https://api.football-data.org/v4/teams/90' -H "X-Auth-Token: UR_TOKEN"{
"area": {
"id": 2224,
"name": "Spain",
"code": "ESP",
"flag": "https://crests.football-data.org/760.svg"
},
"id": 90,
"name": "Real Betis Balompié",
"shortName": "Real Betis",
"tla": "BET",
"crest": "https://crests.football-data.org/90.png",
"address": "Avenida de Heliópolis, s/n Sevilla 41012",
"website": "http://www.realbetisbalompie.es",
"founded": 1907,
"clubColors": "Green / White",
"venue": "Estadio Benito Villamarín",
"runningCompetitions": [
{
"id": 2014,
"name": "Primera Division",
"code": "PD",
"type": "LEAGUE",
"emblem": "https://crests.football-data.org/PD.png"
},
{
"id": 2146,
"name": "UEFA Europa League",
"code": "EL",
"type": "CUP",
"emblem": "https://crests.football-data.org/EL.png"
},
{
"id": 2079,
"name": "Copa del Rey",
"code": "CDR",
"type": "CUP",
"emblem": null
}
],
"coach": {
"id": 11630,
"firstName": "Manuel",
"lastName": "Pellegrini",
"name": "Manuel Pellegrini",
"dateOfBirth": "1953-09-16",
"nationality": "Chile",
"contract": {
"start": "2020-08",
"until": "2023-06"
}
},
"marketValue": 225100000,
"squad": [
{
"id": 7821,
"firstName": "",
"lastName": "Joel",
"name": "Joel Robles",
"position": "Goalkeeper",
"dateOfBirth": "1990-06-17",
"nationality": "Spain",
"shirtNumber": 1,
"marketValue": 2000000,
"contract": {
"start": "2018-07",
"until": "2022-06"
}
},
{
"id": 7879,
"firstName": "Claudio",
"lastName": "Bravo",
"name": "Claudio Bravo",
"position": "Goalkeeper",
"dateOfBirth": "1983-04-13",
"nationality": "Chile",
"shirtNumber": 25,
"marketValue": 900000,
"contract": {
"start": "2020-08",
"until": "2023-06"
}
},
{
"id": 32014,
"firstName": "",
"lastName": "Rui Silva",
"name": "Rui Silva",
"position": "Goalkeeper",
"dateOfBirth": "1994-02-07",
"nationality": "Portugal",
"shirtNumber": 13,
"marketValue": 14000000,
"contract": {
"start": "2021-07",
"until": "2026-06"
}
},
{
"id": 33035,
"firstName": "",
"lastName": "Dani Rebollo",
"name": "Dani Rebollo",
"position": "Goalkeeper",
"dateOfBirth": "1999-12-10",
"nationality": "Spain",
"shirtNumber": 30,
"marketValue": null,
"contract": {
"start": "2021-09",
"until": "2022-06"
}
},
{
"id": 16,
"firstName": "Andrés",
"lastName": "Guardado",
"name": "Andrés Guardado",
"position": "Defence",
"dateOfBirth": "1986-09-28",
"nationality": "Mexico",
"shirtNumber": 18,
"marketValue": 1500000,
"contract": {
"start": "2017-07",
"until": "2023-06"
}
},
{
"id": 1772,
"firstName": "Germán",
"lastName": "Pezzella",
"name": "Germán Pezzella",
"position": "Defence",
"dateOfBirth": "1991-06-27",
"nationality": "Argentina",
"shirtNumber": 16,
"marketValue": 5000000,
"contract": {
"start": "2021-08",
"until": "2025-06"
}
},
{
"id": 3624,
"firstName": "Youssouf",
"lastName": "Sabaly",
"name": "Youssouf Sabaly",
"position": "Defence",
"dateOfBirth": "1993-03-05",
"nationality": "Senegal",
"shirtNumber": 23,
"marketValue": 3000000,
"contract": {
"start": "2021-07",
"until": "2026-06"
}
},
{
"id": 7783,
"firstName": "",
"lastName": "Héctor Bellerín",
"name": "Héctor Bellerín",
"position": "Defence",
"dateOfBirth": "1995-03-19",
"nationality": "Spain",
"shirtNumber": 19,
"marketValue": 20000000,
"contract": {
"start": "2021-08",
"until": "2022-06"
}
},
{
"id": 32123,
"firstName": "",
"lastName": "Álex Moreno",
"name": "Alex Moreno",
"position": "Defence",
"dateOfBirth": "1993-06-08",
"nationality": "Spain",
"shirtNumber": 15,
"marketValue": 10000000,
"contract": {
"start": "2019-08",
"until": "2025-06"
}
},
{
"id": 32491,
"firstName": "",
"lastName": "Juan Miranda",
"name": "Juan Miranda",
"position": "Defence",
"dateOfBirth": "2000-01-19",
"nationality": "Spain",
"shirtNumber": 33,
"marketValue": 6000000,
"contract": {
"start": "2020-10",
"until": "2024-06"
}
},
{
"id": 33038,
"firstName": "",
"lastName": "Bartra",
"name": "Bartra",
"position": "Defence",
"dateOfBirth": "1991-01-15",
"nationality": "Spain",
"shirtNumber": 5,
"marketValue": 6000000,
"contract": {
"start": "2018-07",
"until": "2023-06"
}
},
{
"id": 33106,
"firstName": "",
"lastName": "Víctor Ruiz",
"name": "Víctor Ruíz",
"position": "Defence",
"dateOfBirth": "1989-01-25",
"nationality": "Spain",
"shirtNumber": 6,
"marketValue": 2000000,
"contract": {
"start": "2020-08",
"until": "2023-06"
}
},
{
"id": 33139,
"firstName": "",
"lastName": "Martín Montoya",
"name": "Martín Montoya",
"position": "Defence",
"dateOfBirth": "1991-04-14",
"nationality": "Spain",
"shirtNumber": 2,
"marketValue": 2000000,
"contract": {
"start": "2020-08",
"until": "2024-06"
}
},
{
"id": 58580,
"firstName": "",
"lastName": "Édgar González",
"name": "Édgar González",
"position": "Defence",
"dateOfBirth": "1997-04-01",
"nationality": "Spain",
"shirtNumber": 3,
"marketValue": 5000000,
"contract": {
"start": "2021-07",
"until": "2025-06"
}
},
{
"id": 144708,
"firstName": "",
"lastName": "Marc Baró",
"name": "Marc Baró Ortiz",
"position": "Defence",
"dateOfBirth": "1999-08-23",
"nationality": "Spain",
"shirtNumber": 36,
"marketValue": null,
"contract": {
"start": "2022-01",
"until": "2022-06"
}
},
{
"id": 150595,
"firstName": "",
"lastName": "Fran Delgado",
"name": "Fran Delgado",
"position": "Defence",
"dateOfBirth": "2001-07-11",
"nationality": "Spain",
"shirtNumber": 32,
"marketValue": null,
"contract": {
"start": "2020-09",
"until": "2024-06"
}
},
{
"id": 161288,
"firstName": "",
"lastName": "Kike Hermoso",
"name": "Kike Hermoso",
"position": "Defence",
"dateOfBirth": "1999-08-10",
"nationality": "Spain",
"shirtNumber": 37,
"marketValue": null,
"contract": {
"start": "2021-07",
"until": "2022-06"
}
},
{
"id": 18,
"firstName": "",
"lastName": "Joaquín",
"name": "Joaquín",
"position": "Midfield",
"dateOfBirth": "1981-07-21",
"nationality": "Spain",
"shirtNumber": 17,
"marketValue": 1500000,
"contract": {
"start": "2016-07",
"until": "2022-06"
}
},
{
"id": 25,
"firstName": "",
"lastName": "Canales",
"name": "Canales",
"position": "Midfield",
"dateOfBirth": "1991-02-16",
"nationality": "Spain",
"shirtNumber": 10,
"marketValue": 20000000,
"contract": {
"start": "2019-07",
"until": "2026-06"
}
},
{
"id": 3250,
"firstName": "",
"lastName": "William Carvalho",
"name": "William Carvalho",
"position": "Midfield",
"dateOfBirth": "1992-04-07",
"nationality": "Portugal",
"shirtNumber": 14,
"marketValue": 14000000,
"contract": {
"start": "2018-07",
"until": "2023-06"
}
},
{
"id": 8464,
"firstName": "Nabil",
"lastName": "Fekir",
"name": "Nabil Fekir",
"position": "Midfield",
"dateOfBirth": "1993-07-18",
"nationality": "France",
"shirtNumber": 8,
"marketValue": 30000000,
"contract": {
"start": "2019-07",
"until": "2026-06"
}
},
{
"id": 33040,
"firstName": "",
"lastName": "Víctor Camarasa",
"name": "Víctor Camarasa",
"position": "Midfield",
"dateOfBirth": "1994-05-28",
"nationality": "Spain",
"shirtNumber": 22,
"marketValue": 1200000,
"contract": {
"start": "2021-07",
"until": "2022-06"
}
},
{
"id": 39104,
"firstName": "Guido",
"lastName": "Rodríguez",
"name": "Guido Rodríguez",
"position": "Midfield",
"dateOfBirth": "1994-04-12",
"nationality": "Argentina",
"shirtNumber": 21,
"marketValue": 25000000,
"contract": {
"start": "2020-01",
"until": "2024-06"
}
},
{
"id": 81737,
"firstName": "Paul",
"lastName": "Akouokou",
"name": "Paul Akouokou",
"position": "Midfield",
"dateOfBirth": "1997-12-20",
"nationality": "Ivory Coast",
"shirtNumber": 4,
"marketValue": 2000000,
"contract": {
"start": "2020-09",
"until": "2024-06"
}
},
{
"id": 180064,
"firstName": "",
"lastName": "Marchena",
"name": "Marchena",
"position": "Midfield",
"dateOfBirth": "2002-07-27",
"nationality": "Spain",
"shirtNumber": 38,
"marketValue": null,
"contract": {
"start": "2022-01",
"until": "2022-06"
}
},
{
"id": 2,
"firstName": "",
"lastName": "Juanmi",
"name": "Juanmi",
"position": "Offence",
"dateOfBirth": "1993-05-20",
"nationality": "Spain",
"shirtNumber": 7,
"marketValue": 12000000,
"contract": {
"start": "2019-07",
"until": "2024-06"
}
},
{
"id": 8,
"firstName": "",
"lastName": "Willian José",
"name": "Willian José",
"position": "Offence",
"dateOfBirth": "1991-11-23",
"nationality": "Brazil",
"shirtNumber": 12,
"marketValue": 18000000,
"contract": {
"start": "2021-08",
"until": "2022-06"
}
},
{
"id": 17,
"firstName": "Christian",
"lastName": null,
"name": "Tello",
"position": "Offence",
"dateOfBirth": "1991-08-11",
"nationality": "Spain",
"shirtNumber": 11,
"marketValue": 6000000,
"contract": {
"start": "2017-07",
"until": "2022-06"
}
},
{
"id": 32056,
"firstName": "",
"lastName": "Borja Iglesias",
"name": "Borja Iglesias",
"position": "Offence",
"dateOfBirth": "1993-01-17",
"nationality": "Spain",
"shirtNumber": 9,
"marketValue": 10000000,
"contract": {
"start": "2019-08",
"until": "2026-06"
}
},
{
"id": 33045,
"firstName": "",
"lastName": "Aitor Ruibal",
"name": "Aitor Ruibal",
"position": "Offence",
"dateOfBirth": "1996-03-22",
"nationality": "Spain",
"shirtNumber": 24,
"marketValue": 3000000,
"contract": {
"start": "2020-07",
"until": "2025-06"
}
},
{
"id": 39115,
"firstName": "Diego",
"lastName": "Lainez",
"name": "Diego Lainez",
"position": "Offence",
"dateOfBirth": "2000-06-09",
"nationality": "Mexico",
"shirtNumber": 20,
"marketValue": 5000000,
"contract": {
"start": "2019-07",
"until": "2024-06"
}
},
{
"id": 130324,
"firstName": "",
"lastName": "Raúl",
"name": "Raúl",
"position": "Offence",
"dateOfBirth": "2000-11-03",
"nationality": "Spain",
"shirtNumber": 35,
"marketValue": null,
"contract": {
"start": "2019-09",
"until": "2022-06"
}
},
{
"id": 142393,
"firstName": "",
"lastName": "Rodri",
"name": "Salomón Rodríguez",
"position": "Offence",
"dateOfBirth": "2000-02-16",
"nationality": "Spain",
"shirtNumber": 28,
"marketValue": null,
"contract": {
"start": "2020-06",
"until": "2026-06"
}
},
{
"id": 180037,
"firstName": "",
"lastName": "Cristian Tello",
"name": "Cristian Tello",
"position": "Offence",
"dateOfBirth": "1991-08-11",
"nationality": "Spain",
"shirtNumber": 11,
"marketValue": null,
"contract": {
"start": "2018-07",
"until": "2022-06"
}
}
],
"staff": [
{
"id": 63306,
"firstName": "",
"lastName": "Fernando",
"name": "Fernando Fernández",
"dateOfBirth": "1979-06-02",
"nationality": "Spain",
"contract": {
"start": "2020-08",
"until": "2023-06"
}
},
{
"id": 180098,
"firstName": "",
"lastName": "Doblas",
"name": "Doblas",
"dateOfBirth": "1980-08-05",
"nationality": "Spain",
"contract": {
"start": "2020-09",
"until": "2023-06"
}
},
{
"id": 180135,
"firstName": "Rubén",
"lastName": "Cousillas",
"name": "Rubén Cousillas",
"dateOfBirth": "1957-05-09",
"nationality": "Argentina",
"contract": {
"start": "2020-08",
"until": "2023-06"
}
}
],
"lastUpdated": "2022-05-03T08:22:26Z"
}Matches
You can use the Match Subresource to fetch a list of matches that are pre-filtered by the team.
Click here to see a sample implementation (at the very bottom) with some layers of plumbing and transformation code in between.
curl -XGET 'https://api.football-data.org/v4/teams/583/matches?dateFrom=2021-07-01&dateTo=2022-01-01' -H "X-Auth-Token: UR_TOKEN"Notice the matches are lacking lineups, bookings and so on as we did not set the unfolding headers as explained here.
{
"filters": {
"dateFrom": "2021-07-01",
"dateTo": "2022-01-01",
"permission": "TIER_THREE",
"limit": 100
},
"resultSet": {
"count": 15,
"competitions": "PPL",
"first": "2021-08-07",
"last": "2021-12-28",
"played": 15,
"wins": 6,
"draws": 6,
"losses": 7
},
"matches": [ ... ]
}You see the applied filters on the very top: by default the list is limited to 100 items. this, this is season 2021/22. And we explicitly defined to return only matches of matchday 23. The resultSet node gives the boundaries of the match list, a count and how many matches are in status FINISHED. Last but not least the list of match items follows.
Available filters for Match Subresource
| Filter name | Possible values | Sample |
|---|---|---|
dateFrom |
A date in format yyyy-MM-dd |
/?dateFrom=2022-01-01 |
dateTo |
A date in format yyyy-MM-dd |
/?dateTo=2022-01-10 |
season |
An integer, like [\d]{4} |
/?season=2021 |
status |
Status enum |
/?status=FINISHED |
venue |
Enum [ HOME | AWAY ] |
/?venue=HOME |
limit |
Integer [1-500] |
Limit the result set |