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

400: Bad Request

{
    Request is missing required HTTP header 'Accept'
}

401: Unauthorized

{
    The supplied authentication is invalid
}

200: OK

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