Getting Team Lineups

Using this soccer API endpoint you will get access to the team lineups for the current match.

Endpoint


With this soccer 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


NameTypeRequiredExampleDescription
match_idNumber1194137The 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.


NameTypeExampleDescription
player. substitutionNumber1 / 0Whether the player is starting on the bench (1) or is in the starting eleven players (0)
player. nameStringC. RonaldoThe name of the player
player.idNumber123The id of the player in our database
player.team_idNumber23The id of the team which the player is representing in this match
player.shirt_numberNumber26The number of the shirt that the player is wearing

{
    "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"
                    }
                ]
            }
        }
    }
}