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

Legacy - GET https://dde-api.data.imgarena.com/soccer/fixtures/{fixtureID}/lineups (decommissioning on 30th Sept 2026)

NEW - GET https://dde-api.data.srarena.io/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'
}

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

PreviousStandings NextHealthcheck

Last updated 12 days ago

Was this helpful?

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