GETMatch lineups Standard, World Cup
Formations and starting lineups with position and shirt number.
/v2.2/fixtures/ with t=match_lineups
Try it in the interactive referenceAll Fixtures operations
Request
GET /v2.2/fixtures/?api_key=API_KEY&t=match_lineups&id=2589310&include=stats
- Plans: Standard, World Cup. Free plans carry the Standard datasets. Other plans receive
403 with meta.msg = Endpoint not available for your plan. - Authenticate with
api_key=API_KEY in the URL, or Authorization: Bearer API_KEY as an alternative. Both use the same key, without a username. See authentication methods.
Parameters
| Name | Required | Description | Example |
|---|
id | yes | Match ID. | 2589310 |
lang | no | Language code for localized catalogue names. Available codes: en, el, aa, it, de, es, ru, nl, pl, fr, pt, ka, vi, hi, tr, id, th, zh, zht, ro, ko and fa. Legacy aliases: gr maps to el, and ar maps to aa. Defaults to en; an unavailable code returns 400 Bad Request. Proper names can remain unchanged, and match, event, odds and statistics payloads are not translated. | en |
Example response
{
"data": {
"home": {
"formation": "3-4-2-1",
"confirmed_formation": 1,
"squad": [
{
"player": {
"id": "323",
"name": "Martinez, Emilano",
"common_name": "Martinez, Emilano",
"firstname": "Damian Emiliano",
"lastname": "Martinez",
"weight": "89",
"height": "195",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/323.png",
"country": {
"id": "12",
"name": "Argentina",
"cc": "ar"
}
},
"number": "26",
"captain": null,
"position": "G",
"position_name": null,
"order": 1
}
]
},
"away": {
"formation": "4-2-3-1",
"confirmed_formation": 1,
"squad": [
{
"player": {
"id": "5393",
"name": "Verbruggen, Bart",
"common_name": "Verbruggen, Bart",
"firstname": "Bart",
"lastname": "Verbruggen",
"weight": "87",
"height": "193",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/5393.png",
"country": {
"id": "81",
"name": "Netherlands",
"cc": "nl"
}
},
"number": "1",
"captain": null,
"position": "G",
"position_name": null,
"order": 1
}
]
}
},
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 1,
"total": 1,
"msg": ""
}
}
