Match lineups
Using this football API endpoint you will get access to the team lineups for the current match.
Endpoint
With this football API endpoint, you can answer the question of what players will take part in a certain game. The endpoint takes as a parameter the match_id of the match in which lineups you are interested in. The match could be a live match, a match that is going to start soon, or a match that has finished. In response to your api request, you will find a bit of information about the teams as well as the lineups of the teams if such are available. The availability of the lineups depends on the popularity of the competition and the importance of the match.
GET:
Parameters
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| match_id | Number | 1 | 194137 | The id of the match for which we would like to get the lineups for. |
Response
In the response, you will find a little bit of information about the 2 teams located under the keys home and away as well as the lineups if such are available.
| Name | Type | Example | Description |
|---|---|---|---|
| player. name | String | C. Ronaldo | The name of the player |
| player. substitution | Number | 1 / 0 | Whether the player is starting on the bench (1) or is in the starting eleven players (0) |
| player.id | Number | 123 | The id of the player in our database |
| player.shirt_number | Number | 26 | The number of the shirt that the player is wearing |
| player.team_id | Number | 23 | The id of the team which the player is representing in this match |
{
"success": true,
"data": {
"lineup": {
"home": {
"team": {
"id": "2210",
"name": "Estudiantes Merida",
"stadium": "Estadio Ol\u00edmpico Metropolitano de M\u00e9rida",
"location": "Estadio Ol\u00edmpico Metropolitano de M\u00e9rida"
},
"players": [
{
"team_id": "2210",
"id": "41983",
"name": "Alejandro Araque",
"substitution": "0",
"shirt_number": "1"
},
{
"team_id": "2210",
"id": "42001",
"name": "Daniel Linarez",
"substitution": "0",
"shirt_number": "3"
},
{
"team_id": "2210",
"id": "41998",
"name": "Christian Flores",
"substitution": "0",
"shirt_number": "7"
},
{
"team_id": "2210",
"id": "41997",
"name": "Jesus Meza",
"substitution": "0",
"shirt_number": "10"
},
{
"team_id": "2210",
"id": "42016",
"name": "Jose Luis Marrufo",
"substitution": "0",
"shirt_number": "13"
},
{
"team_id": "2210",
"id": "41991",
"name": "Cristian Rivas",
"substitution": "0",
"shirt_number": "15"
},
{
"team_id": "2210",
"id": "41958",
"name": "Armando Jose Araque Pena",
"substitution": "0",
"shirt_number": "17"
},
{
"team_id": "2210",
"id": "41999",
"name": "Jose Manriquez",
"substitution": "0",
"shirt_number": "20"
},
{
"team_id": "2210",
"id": "42020",
"name": "Edison Jose Penilla Herrera",
"substitution": "0",
"shirt_number": "23"
},
{
"team_id": "2210",
"id": "86157",
"name": "Jose Rivas",
"substitution": "0",
"shirt_number": "27"
},
{
"team_id": "2210",
"id": "42014",
"name": "Alexis Messidoro",
"substitution": "0",
"shirt_number": "28"
},
{
"team_id": "2210",
"id": "41984",
"name": "Omar Labrador",
"substitution": "1",
"shirt_number": "2"
},
{
"team_id": "2210",
"id": "42000",
"name": "Galileo Del Castillo",
"substitution": "1",
"shirt_number": "5"
},
{
"team_id": "2210",
"id": "42002",
"name": "Luz Rodriguez",
"substitution": "1",
"shirt_number": "9"
},
{
"team_id": "2210",
"id": "42017",
"name": "Edward Morillo",
"substitution": "1",
"shirt_number": "11"
},
{
"team_id": "2210",
"id": "42013",
"name": "Ayrton Paez",
"substitution": "1",
"shirt_number": "14"
},
{
"team_id": "2210",
"id": "42022",
"name": "Jaime Moreno",
"substitution": "1",
"shirt_number": "16"
},
{
"team_id": "2210",
"id": "42019",
"name": "Matias Nicolas Draghi",
"substitution": "1",
"shirt_number": "22"
},
{
"team_id": "2210",
"id": "42004",
"name": "Ronaldo Rivas",
"substitution": "1",
"shirt_number": "24"
},
{
"team_id": "2210",
"id": "41989",
"name": "Edson Rivas",
"substitution": "1",
"shirt_number": "29"
},
{
"team_id": "2210",
"id": "41995",
"name": "Edgardo Rondon",
"substitution": "1",
"shirt_number": "30"
}
]
},
"away": {
"team": {
"id": "935",
"name": "Racing Club",
"stadium": "Estadio Presidente Juan Domingo Per\u00f3n",
"location": "Estadio Presidente Juan Domingo Per\u00f3n"
},
"players": [
{
"team_id": "935",
"id": "14654",
"name": "Gabriel Arias",
"substitution": "0",
"shirt_number": "1"
},
{
"team_id": "935",
"id": "14644",
"name": "Ivan Pillud",
"substitution": "0",
"shirt_number": "4"
},
{
"team_id": "935",
"id": "14657",
"name": "Eugenio Mena",
"substitution": "0",
"shirt_number": "5"
},
{
"team_id": "935",
"id": "14664",
"name": "Matias Rojas",
"substitution": "0",
"shirt_number": "10"
},
{
"team_id": "935",
"id": "14645",
"name": "Lisandro Lopez",
"substitution": "0",
"shirt_number": "15"
},
{
"team_id": "935",
"id": "14655",
"name": "Mauricio Martinez",
"substitution": "0",
"shirt_number": "16"
},
{
"team_id": "935",
"id": "14672",
"name": "Leonel Miranda",
"substitution": "0",
"shirt_number": "19"
},
{
"team_id": "935",
"id": "14656",
"name": "Marcelo Diaz",
"substitution": "0",
"shirt_number": "21"
},
{
"team_id": "935",
"id": "14647",
"name": "Federico Zaracho",
"substitution": "0",
"shirt_number": "28"
},
{
"team_id": "935",
"id": "14667",
"name": "Nicolas Reniero",
"substitution": "0",
"shirt_number": "29"
},
{
"team_id": "935",
"id": "14652",
"name": "Leonardo Sigali",
"substitution": "0",
"shirt_number": "30"
},
{
"team_id": "935",
"id": "14675",
"name": "Juan Jose Caceres",
"substitution": "1",
"shirt_number": "2"
},
{
"team_id": "935",
"id": "14650",
"name": "Alexis Soto",
"substitution": "1",
"shirt_number": "3"
},
{
"team_id": "935",
"id": "14648",
"name": "Lucas Orban",
"substitution": "1",
"shirt_number": "6"
},
{
"team_id": "935",
"id": "14673",
"name": "Hector Fertoli",
"substitution": "1",
"shirt_number": "7"
},
{
"team_id": "935",
"id": "14665",
"name": "David Barbona",
"substitution": "1",
"shirt_number": "11"
},
{
"team_id": "935",
"id": "14651",
"name": "Javier Garcia",
"substitution": "1",
"shirt_number": "13"
},
{
"team_id": "935",
"id": "14671",
"name": "Benjamin Garre",
"substitution": "1",
"shirt_number": "17"
},
{
"team_id": "935",
"id": "14659",
"name": "Dario Cvitanich",
"substitution": "1",
"shirt_number": "20"
},
{
"team_id": "935",
"id": "14666",
"name": "Walter Montoya",
"substitution": "1",
"shirt_number": "22"
},
{
"team_id": "935",
"id": "14646",
"name": "Gaston Gomez",
"substitution": "1",
"shirt_number": "25"
},
{
"team_id": "935",
"id": "14676",
"name": "Tiago Banega",
"substitution": "1",
"shirt_number": "27"
}
]
}
}
}
}