> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/soccer/rest-api/lineups.md). # 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 | {% tabs %} {% tab title="400: Bad Request " %} ```json { Request is missing required HTTP header 'Accept' } ``` {% endtab %} {% tab title="401: Unauthorized " %} ```json { The supplied authentication is invalid } ``` {% endtab %} {% tab title="200: OK " %} ````json { "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" } ] } } ``` ```` {% endtab %} {% endtabs %} ### Response fields
PropertyDescription
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} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.sportradar.com/soccer/rest-api/lineups.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.