Lineups
The Lineups API lets developers get a list of lineups for a fixture when they are known.
Per each fixture, this endpoint will return the following information regarding the lineup:
fixtureId
home team Id
away team Id
startingLineup
substitutes players
Endpoints
List season squads
GET https://dde-api.data.imgarena.com/soccer/fixtures/{fixtureID}/lineups
Retrieves a list of players associated to certain teams.
Path Parameters
Name
Type
Description
fixtureID
String
unique id of a requested fixture
Headers
Name
Type
Description
Accept*
String
application/vnd.imggaming.dde.api+json;version=1
Authorization*
String
Bearer ACCESS_TOKEN
Content-Type*
String
application/json
{
Request is missing required HTTP header 'Accept'
}{
The supplied authentication is invalid
}{
"fixtureId": "f40e7aa9-1c09-4110-b5d5-6d2abc84d3f3",
"home": {
"teamId": "bd43dd5b-edd1-4327-b068-47815a29dc91",
"startingLineup": [
{
"id": "62cdf906-15ef-48db-8b9f-cd9fa0d02a82",
"shirtNumber": "11",
"fullName": "Samuel Gustafson",
"firstName": "Samuel",
"lastName": "Gustafson"
},
{
"id": "c197bfd4-238f-4b7a-a853-046787313e89",
"shirtNumber": "8",
"fullName": "Abdulrazaq Ishaq",
"firstName": "Abdulrazaq",
"lastName": "Ishaq"
},
{
"id": "dbda6dbf-883b-411a-8cb9-2c091b8b33cb",
"shirtNumber": "4",
"fullName": "Aiham Ousou",
"firstName": "Aiham",
"lastName": "Ousou"
},
{
"id": "3def2bdb-88f4-400f-9df2-81a788f8179f",
"shirtNumber": "24",
"fullName": "Amor Layouni",
"firstName": "Amor",
"lastName": "Layouni"
},
{
"id": "854db135-e3e6-44ee-8484-30d1d1656b5c",
"shirtNumber": "3",
"fullName": "Johan Hammar",
"firstName": "Johan",
"lastName": "Hammar"
},
{
"id": "cb58edb4-0a6b-4bc7-93fb-ce3cb8d822b0",
"shirtNumber": "17",
"fullName": "Edward Chilufya",
"firstName": "Edward",
"lastName": "Chilufya"
},
{
"id": "44b17130-53a5-4f09-9775-dc6351b9d377",
"shirtNumber": "26",
"fullName": "Peter Abrahamsson",
"firstName": "Peter",
"lastName": "Abrahamsson"
},
{
"id": "358cd0b0-90de-44be-95e7-2afd022125ad",
"shirtNumber": "21",
"fullName": "Tomas Olai Totland",
"firstName": "Tomas",
"lastName": "Olai Totland"
},
{
"id": "4a23526c-51a4-4b6b-93af-21cd20485865",
"shirtNumber": "23",
"fullName": "Momodou Sonko",
"firstName": "Momodou",
"lastName": "Sonko"
},
{
"id": "f5be346e-4035-4b57-97e0-e6df77919663",
"shirtNumber": "16",
"fullName": "Pontus Dahbo",
"firstName": "Pontus",
"lastName": "Dahbo"
},
{
"id": "49400ea5-d704-4a82-a805-9fd4bedb2371",
"shirtNumber": "13",
"fullName": "Simon Sandberg",
"firstName": "Simon",
"lastName": "Sandberg"
}
],
"substitutes": [
{
"id": "d2a61cc3-7fa8-4101-a39c-f2184e0ebe49",
"shirtNumber": "25",
"fullName": "A Faye",
"firstName": "A",
"lastName": "Faye"
},
{
"id": "98fd579f-5e34-4812-8a88-bd9e1b652764",
"shirtNumber": "15",
"fullName": "Kadir Hodzic",
"firstName": "Kadir",
"lastName": "Hodzic"
},
{
"id": "e7532569-a6d5-46dd-96e6-adff3ea9cb0c",
"shirtNumber": "33",
"fullName": "Johan Paul Dembe",
"firstName": "Johan Paul",
"lastName": "Dembe"
},
{
"id": "4b6537cc-9812-400b-b5e1-8fa65d929587",
"shirtNumber": "35",
"fullName": "Segge Jansson",
"firstName": "Segge",
"lastName": "Jansson"
},
{
"id": "dc4d6493-39e7-443f-a02f-3406fb9c3c53",
"shirtNumber": "5",
"fullName": "Even Hovland",
"firstName": "Even",
"lastName": "Hovland"
},
{
"id": "7ff96354-2cb6-423c-8b05-aff868c2597c",
"shirtNumber": "22",
"fullName": "Tobias Sana",
"firstName": "Tobias",
"lastName": "Sana"
},
{
"id": "903c1b75-3358-4080-b291-792a364ee932",
"shirtNumber": "39",
"fullName": "Isak Brusberg",
"firstName": "Isak",
"lastName": "Brusberg"
},
{
"id": "7ecd1a29-49f5-42f5-ac2b-371b3b76b742",
"shirtNumber": "19",
"fullName": "Srdjan Hrstic",
"firstName": "Srdjan",
"lastName": "Hrstic"
},
{
"id": "a0b7a05c-16ae-45cd-a3f1-a999c033d03a",
"shirtNumber": "1",
"fullName": "Johan Brattberg",
"firstName": "Johan",
"lastName": "Brattberg"
}
]
},
"away": {
"teamId": "dba97af3-f3cb-4356-adad-72f45a3b4a09",
"startingLineup": [
{
"id": "76456fed-85eb-4544-aac5-a10696d90c8a",
"shirtNumber": "9",
"fullName": "Isaac Thelin",
"firstName": "Isaac",
"lastName": "Thelin"
},
{
"id": "d12bacd5-9e80-411d-a7f1-1726694640f7",
"shirtNumber": "27",
"fullName": "Johan Dahlin",
"firstName": "Johan",
"lastName": "Dahlin"
},
{
"id": "8e74629c-493d-489b-8d4e-a325e1d67833",
"shirtNumber": "25",
"fullName": "Gabriel Dal Toe Busanello",
"firstName": "Gabriel",
"lastName": "Dal Toe Busanello"
},
{
"id": "24db42f8-df48-4acb-b4c3-19b5ad5aa90f",
"shirtNumber": "17",
"fullName": "O Rosengren",
"firstName": "O",
"lastName": "Rosengren"
},
{
"id": "787a60b7-f8de-4dc8-8d10-bceac0956a1b",
"shirtNumber": "21",
"fullName": "Stefano Vecchia",
"firstName": "Stefano",
"lastName": "Vecchia"
},
{
"id": "698b3db8-10e2-4ca5-bdd2-8d5a40819515",
"shirtNumber": "13",
"fullName": "Martin Olsson",
"firstName": "Martin",
"lastName": "Olsson"
},
{
"id": "cae34cf6-96ff-4abc-a3e0-fe3e6ebe0541",
"shirtNumber": "18",
"fullName": "Pontus Jansson",
"firstName": "Pontus",
"lastName": "Jansson"
},
{
"id": "31f94880-4882-471d-88c6-243df46c44f4",
"shirtNumber": "8",
"fullName": "Sergio Peña Flores",
"firstName": "Sergio",
"lastName": "Peña Flores"
},
{
"id": "b218f7cd-a9df-4734-b2d0-6336ac46f204",
"shirtNumber": "11",
"fullName": "sebastian Nanasi",
"firstName": "sebastian",
"lastName": "Nanasi"
},
{
"id": "8badf92f-2cc8-40cd-a036-6cf8e67ee501",
"shirtNumber": "19",
"fullName": "Derek Cornelius",
"firstName": "Derek",
"lastName": "Cornelius"
},
{
"id": "4cd5da57-b403-41de-a8cf-8c6bd05d87a7",
"shirtNumber": "5",
"fullName": "S�ren Rieks",
"firstName": "S�ren",
"lastName": "Rieks"
}
],
"substitutes": [
{
"id": "cedfe227-e059-4be8-8bdc-87746623a83f",
"shirtNumber": "6",
"fullName": "Oscar Lewicki",
"firstName": "Oscar",
"lastName": "Lewicki"
},
{
"id": "02151410-f00a-404b-8bce-6bec4249369d",
"shirtNumber": "7",
"fullName": "Mahamé Siby",
"firstName": "Mahamé",
"lastName": "Siby"
},
{
"id": "3c9ac20a-671c-4f68-814d-720f0a4a1d84",
"shirtNumber": "4",
"fullName": "Niklas Moisander",
"firstName": "Niklas",
"lastName": "Moisander"
},
{
"id": "08c8ebf2-9e5c-4203-8981-ad8abb05c6a2",
"shirtNumber": "22",
"fullName": "Taha Abdi Ali",
"firstName": "Taha",
"lastName": "Abdi Ali"
},
{
"id": "b5280e7e-9b1d-4802-b58e-c58bc7efc4d2",
"shirtNumber": "3",
"fullName": "Jonas Bruun Knudsen",
"firstName": "Jonas",
"lastName": "Bruun Knudsen"
},
{
"id": "3e319d0b-92db-46b7-80cc-df0ae253046e",
"shirtNumber": "30",
"fullName": "Ismael Diawara",
"firstName": "Ismael",
"lastName": "Diawara"
},
{
"id": "2f444eb3-1fb6-4666-922c-ced1b543f7ea",
"shirtNumber": "37",
"fullName": "Adrian Skogmar",
"firstName": "Adrian",
"lastName": "Skogmar"
},
{
"id": "ef8180cd-f839-4cf9-a428-20d066aaf803",
"shirtNumber": "23",
"fullName": "L Johnsen",
"firstName": "L",
"lastName": "Johnsen"
},
{
"id": "2bd63ea8-96f4-446d-b6ff-24db08d8aa6c",
"shirtNumber": "14",
"fullName": "S Jorgensen",
"firstName": "S",
"lastName": "Jorgensen"
}
]
}
}
```Response fields
lineups lineups
The requested list of possible values for lineups
Polling frequency
We recommend that you poll this endpoint every 30 seconds. Note that if lineup details are not available, we will return error code 404 - No lineup available for fixture: {fixtureId}
Last updated