Through this football API endpoint you obtain access to the team lineups for a match.
Endpoint
With this football API endpoint, you can figure out which players are going to feature in a particular game. You just pass the match_id of the match you care about as a parameter. That match could be live right now, about to kick off, or already finished. When you fire off your api request, you get back details about the teams plus their lineups whenever those are on hand. Whether lineups show up depends on how popular the competition is and how big the match is.
Check this Football API endpoint in our postman collection. Download it now!
Parameters
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| lang | String | de | The language you want the data delivered in, picked from our list of supported data languages | |
| match_id | Number | 1 | 194137 | The id of the match you want the lineups for. |
Response
Inside the response, you will come across a snippet of information about the two teams, sitting under the home and away keys, together with the lineups whenever those are present.
| Name | Type | Example | Description |
|---|---|---|---|
| player. name | String | C. Ronaldo | The name of the player. |
| player. substitution | Number | 1 / 0 | Tells you if the player is starting on the bench (1) or in the starting eleven (0). |
| player.id | Number | 123 | The player_id in our database. |
| player.shirt_number | Number | 26 | The shirt number the player is wearing. |
| player.team_id | Number | 23 | The team_id of the side the player is representing in this match. |
{
"success": true,
"data": {
"lineup": {
"home": {
"team": {
"id": "2210",
"name": "Estudiantes Merida",
"country_id": "45",
"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",
"photo": "https:\/\/cdn.football-api.com\/players\/5\/f\/6\/8\/5f68d79da98d5ad7e2fa873c8c8c0383.png"
},
{
"team_id": "2210",
"id": "42001",
"name": "Daniel Linarez",
"substitution": "0",
"shirt_number": "3",
"photo": "https:\/\/cdn.football-api.com\/players\/7\/5\/3\/d\/753dba7a1e2b2511de6aaefc613b7aeb.png"
}
]
},
"away": {
"team": {
"id": "935",
"name": "Racing Club",
"country_id": "65",
"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",
"photo": "https:\/\/cdn.football-api.com\/players\/b\/e\/a\/9\/bea99816975d4154590d05ce68da8b63.png"
},
{
"team_id": "935",
"id": "14644",
"name": "Ivan Pillud",
"substitution": "0",
"shirt_number": "4",
"photo": "https:\/\/cdn.football-api.com\/players\/5\/8\/c\/1\/58c1dbad4977b4c106bca8015477757e.png"
}
]
}
}
}
}