# Squads Per each competition, this endpoint will return the following information: * Name of the competition * Team name & Id * Player forename, lastname and Id * Shirt Number * Nationality ## Endpoints ## List season squads `GET` `https://dde-api.data.imgarena.com/soccer/seasons/{seasonId}/squads` Retrieves a list of players associated to certain teams. #### Path Parameters | Name | Type | Description | | -------- | ------ | ------------------------------- | | seasonId | String | unique id of a requested season | #### 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 [ { "id": "f0e61bd2-a19b-4a4f-b544-d08e745bc8ee", "season": { "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343", "name": "Season 2022/2023" }, "team": { "id": "f14fd931-a113-4a0b-9c5c-532057c96301", "name": "Jonava BC Cbet" }, "players": [ { "id": "6f549898-4550-4d90-a66d-80c4fd69fde5", "fullName": "Arturas Valeika", "firstName": "Arturas", "lastName": "Valeika", "shirtNumber": "7", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "938ff687-2ef4-4ff6-bbbd-08afd0c6d651", "fullName": "Lukas Kreismontas", "firstName": "Lukas", "lastName": "Kreismontas", "shirtNumber": "88", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "86b8a861-756f-4fc0-981d-832544156add", "fullName": "Nedas Raulusevicius", "firstName": "Nedas", "lastName": "Raulusevicius", "shirtNumber": "10", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "9451b514-4f11-4949-81af-7e931c3580f4", "fullName": "Adomas Sidarevicius", "firstName": "Adomas", "lastName": "Sidarevicius", "shirtNumber": "13", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "626bebc2-2dfe-4971-9774-94e2bd8d393f", "fullName": "Martins Laksa", "firstName": "Martins", "lastName": "Laksa", "shirtNumber": "25", "location": { "name": "Latvia", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "cf9efd6b-d78e-4fee-9908-3de1bb01653e", "fullName": "Robertas Sycius", "firstName": "Robertas", "lastName": "Sycius", "shirtNumber": "3", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "5d400818-e3f8-4f69-989c-17c57829005b", "fullName": "Edvinas Seskus", "firstName": "Edvinas", "lastName": "Seskus", "shirtNumber": "9", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "a6a9e4b9-fa4a-42f9-a28f-de69e47506e2", "fullName": "Mantvydas Staniulis", "firstName": "Mantvydas", "lastName": "Staniulis", "shirtNumber": "_11", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "50100052-929f-4858-be21-82e60e46236f", "fullName": "Goran Huskic", "firstName": "Goran", "lastName": "Huskic", "shirtNumber": "23", "location": { "name": "Serbia", "country": {}, "continent": {} }, "verified": true }, { "id": "60afeb8e-7e82-4277-859c-b2948c5a7aaa", "fullName": "Dovis Bickauskis", "firstName": "Dovis", "lastName": "Bickauskis", "shirtNumber": "2", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "3b2e71ab-b62e-4f5c-ae1c-3ddcedb62fae", "fullName": "Xavier Thames", "firstName": "Xavier", "lastName": "Thames", "shirtNumber": "11", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true }, { "id": "acda7582-9a2f-49c9-a41c-789d4e4f7dcd", "fullName": "Vytautas Sulskis", "firstName": "Vytautas", "lastName": "Sulskis", "shirtNumber": "8", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "bb7dc8fb-0da6-4d35-bf46-304e3dfb5ad4", "fullName": "Glynn Watson", "firstName": "Glynn", "lastName": "Watson", "shirtNumber": "5", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "5dc800a5-093a-441d-b852-d6338b416663", "fullName": "Jeffery Garrett", "firstName": "Jeffery", "lastName": "Garrett", "shirtNumber": "4", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true } ] }, { "id": "14191337-8065-4c21-b553-d2f11900913d", "season": { "id": "8bfdde3e-0857-49c9-9915-8f08aaa3e1ca", "name": "Season 2022/2023" }, "team": { "id": "f14fd931-a113-4a0b-9c5c-532057c96301", "name": "Jonava BC Cbet" }, "players": [ { "id": "86b8a861-756f-4fc0-981d-832544156add", "fullName": "Nedas Raulusevicius", "firstName": "Nedas", "lastName": "Raulusevicius", "shirtNumber": "10", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "6f549898-4550-4d90-a66d-80c4fd69fde5", "fullName": "Arturas Valeika", "firstName": "Arturas", "lastName": "Valeika", "shirtNumber": "7", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "61d82a01-0788-4c1a-a866-3f21bfad73b6", "fullName": "Mantvydas Staniulis", "firstName": "Mantvydas", "lastName": "Staniulis", "shirtNumber": "11", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "9451b514-4f11-4949-81af-7e931c3580f4", "fullName": "Adomas Sidarevicius", "firstName": "Adomas", "lastName": "Sidarevicius", "shirtNumber": "13", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "cf9efd6b-d78e-4fee-9908-3de1bb01653e", "fullName": "Robertas Sycius", "firstName": "Robertas", "lastName": "Sycius", "shirtNumber": "3", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "acda7582-9a2f-49c9-a41c-789d4e4f7dcd", "fullName": "Vytautas Sulskis", "firstName": "Vytautas", "lastName": "Sulskis", "shirtNumber": "8", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "938ff687-2ef4-4ff6-bbbd-08afd0c6d651", "fullName": "Lukas Kreismontas", "firstName": "Lukas", "lastName": "Kreismontas", "shirtNumber": "88", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "626bebc2-2dfe-4971-9774-94e2bd8d393f", "fullName": "Martins Laksa", "firstName": "Martins", "lastName": "Laksa", "shirtNumber": "25", "location": { "name": "Latvia", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "60afeb8e-7e82-4277-859c-b2948c5a7aaa", "fullName": "Dovis Bickauskis", "firstName": "Dovis", "lastName": "Bickauskis", "shirtNumber": "2", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "50100052-929f-4858-be21-82e60e46236f", "fullName": "Goran Huskic", "firstName": "Goran", "lastName": "Huskic", "shirtNumber": "23", "location": { "name": "Serbia", "country": {}, "continent": {} }, "verified": true }, { "id": "1a227415-970c-4bf6-9704-a431870860e5", "fullName": "Glynn Watson", "firstName": "Glynn", "lastName": "Watson", "shirtNumber": "5", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "3b2e71ab-b62e-4f5c-ae1c-3ddcedb62fae", "fullName": "Xavier Thames", "firstName": "Xavier", "lastName": "Thames", "shirtNumber": "11", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true }, { "id": "5dc800a5-093a-441d-b852-d6338b416663", "fullName": "Jeffery Garrett", "firstName": "Jeffery", "lastName": "Garrett", "shirtNumber": "4", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true }, { "id": "5d400818-e3f8-4f69-989c-17c57829005b", "fullName": "Edvinas Seskus", "firstName": "Edvinas", "lastName": "Seskus", "shirtNumber": "9", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true } ] } ] ``` {% endtab %} {% endtabs %} ## List team squads `GET` `https://dde-api.data.imgarena.com/soccer/squads/{teamId}` #### Path Parameters | Name | Type | Description | | ---------------------------------------- | ---- | ----------------------------- | | teamId\* | UUID | unique id of a requested team | {% tabs %} {% tab title="200: OK " %} ```json [ { "id": "f0e61bd2-a19b-4a4f-b544-d08e745bc8ee", "season": { "id": "7ac2140e-dd57-404a-bc3a-54d7fcd97343", "name": "Season 2022/2023" }, "team": { "id": "f14fd931-a113-4a0b-9c5c-532057c96301", "name": "Jonava BC Cbet" }, "players": [ { "id": "6f549898-4550-4d90-a66d-80c4fd69fde5", "fullName": "Arturas Valeika", "firstName": "Arturas", "lastName": "Valeika", "shirtNumber": "7", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "938ff687-2ef4-4ff6-bbbd-08afd0c6d651", "fullName": "Lukas Kreismontas", "firstName": "Lukas", "lastName": "Kreismontas", "shirtNumber": "88", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "86b8a861-756f-4fc0-981d-832544156add", "fullName": "Nedas Raulusevicius", "firstName": "Nedas", "lastName": "Raulusevicius", "shirtNumber": "10", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "9451b514-4f11-4949-81af-7e931c3580f4", "fullName": "Adomas Sidarevicius", "firstName": "Adomas", "lastName": "Sidarevicius", "shirtNumber": "13", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "626bebc2-2dfe-4971-9774-94e2bd8d393f", "fullName": "Martins Laksa", "firstName": "Martins", "lastName": "Laksa", "shirtNumber": "25", "location": { "name": "Latvia", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "cf9efd6b-d78e-4fee-9908-3de1bb01653e", "fullName": "Robertas Sycius", "firstName": "Robertas", "lastName": "Sycius", "shirtNumber": "3", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "5d400818-e3f8-4f69-989c-17c57829005b", "fullName": "Edvinas Seskus", "firstName": "Edvinas", "lastName": "Seskus", "shirtNumber": "9", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "a6a9e4b9-fa4a-42f9-a28f-de69e47506e2", "fullName": "Mantvydas Staniulis", "firstName": "Mantvydas", "lastName": "Staniulis", "shirtNumber": "_11", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "50100052-929f-4858-be21-82e60e46236f", "fullName": "Goran Huskic", "firstName": "Goran", "lastName": "Huskic", "shirtNumber": "23", "location": { "name": "Serbia", "country": {}, "continent": {} }, "verified": true }, { "id": "60afeb8e-7e82-4277-859c-b2948c5a7aaa", "fullName": "Dovis Bickauskis", "firstName": "Dovis", "lastName": "Bickauskis", "shirtNumber": "2", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "3b2e71ab-b62e-4f5c-ae1c-3ddcedb62fae", "fullName": "Xavier Thames", "firstName": "Xavier", "lastName": "Thames", "shirtNumber": "11", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true }, { "id": "acda7582-9a2f-49c9-a41c-789d4e4f7dcd", "fullName": "Vytautas Sulskis", "firstName": "Vytautas", "lastName": "Sulskis", "shirtNumber": "8", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "bb7dc8fb-0da6-4d35-bf46-304e3dfb5ad4", "fullName": "Glynn Watson", "firstName": "Glynn", "lastName": "Watson", "shirtNumber": "5", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "5dc800a5-093a-441d-b852-d6338b416663", "fullName": "Jeffery Garrett", "firstName": "Jeffery", "lastName": "Garrett", "shirtNumber": "4", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true } ] }, { "id": "14191337-8065-4c21-b553-d2f11900913d", "season": { "id": "8bfdde3e-0857-49c9-9915-8f08aaa3e1ca", "name": "Season 2022/2023" }, "team": { "id": "f14fd931-a113-4a0b-9c5c-532057c96301", "name": "Jonava BC Cbet" }, "players": [ { "id": "86b8a861-756f-4fc0-981d-832544156add", "fullName": "Nedas Raulusevicius", "firstName": "Nedas", "lastName": "Raulusevicius", "shirtNumber": "10", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "6f549898-4550-4d90-a66d-80c4fd69fde5", "fullName": "Arturas Valeika", "firstName": "Arturas", "lastName": "Valeika", "shirtNumber": "7", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "61d82a01-0788-4c1a-a866-3f21bfad73b6", "fullName": "Mantvydas Staniulis", "firstName": "Mantvydas", "lastName": "Staniulis", "shirtNumber": "11", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "9451b514-4f11-4949-81af-7e931c3580f4", "fullName": "Adomas Sidarevicius", "firstName": "Adomas", "lastName": "Sidarevicius", "shirtNumber": "13", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "cf9efd6b-d78e-4fee-9908-3de1bb01653e", "fullName": "Robertas Sycius", "firstName": "Robertas", "lastName": "Sycius", "shirtNumber": "3", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "acda7582-9a2f-49c9-a41c-789d4e4f7dcd", "fullName": "Vytautas Sulskis", "firstName": "Vytautas", "lastName": "Sulskis", "shirtNumber": "8", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "938ff687-2ef4-4ff6-bbbd-08afd0c6d651", "fullName": "Lukas Kreismontas", "firstName": "Lukas", "lastName": "Kreismontas", "shirtNumber": "88", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "626bebc2-2dfe-4971-9774-94e2bd8d393f", "fullName": "Martins Laksa", "firstName": "Martins", "lastName": "Laksa", "shirtNumber": "25", "location": { "name": "Latvia", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "60afeb8e-7e82-4277-859c-b2948c5a7aaa", "fullName": "Dovis Bickauskis", "firstName": "Dovis", "lastName": "Bickauskis", "shirtNumber": "2", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true }, { "id": "50100052-929f-4858-be21-82e60e46236f", "fullName": "Goran Huskic", "firstName": "Goran", "lastName": "Huskic", "shirtNumber": "23", "location": { "name": "Serbia", "country": {}, "continent": {} }, "verified": true }, { "id": "1a227415-970c-4bf6-9704-a431870860e5", "fullName": "Glynn Watson", "firstName": "Glynn", "lastName": "Watson", "shirtNumber": "5", "location": { "country": {}, "continent": {} }, "verified": true }, { "id": "3b2e71ab-b62e-4f5c-ae1c-3ddcedb62fae", "fullName": "Xavier Thames", "firstName": "Xavier", "lastName": "Thames", "shirtNumber": "11", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true }, { "id": "5dc800a5-093a-441d-b852-d6338b416663", "fullName": "Jeffery Garrett", "firstName": "Jeffery", "lastName": "Garrett", "shirtNumber": "4", "location": { "name": "USA", "country": {}, "continent": { "name": "North America" } }, "verified": true }, { "id": "5d400818-e3f8-4f69-989c-17c57829005b", "fullName": "Edvinas Seskus", "firstName": "Edvinas", "lastName": "Seskus", "shirtNumber": "9", "location": { "name": "Lithuania", "country": {}, "continent": { "name": "Europe" } }, "verified": true } ] } ] ``` {% endtab %} {% 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 %} {% endtabs %} ### Response fields
PropertyDescription
squad
Squad []		The requested list of players within a squad
## Polling frequency We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times - `once per 24 hours` ## Pagination Please find the following link to the [pagination](https://docs.sportradar.com/soccer/readme/pagination) page. {% hint style="warning" %} We kindly request your thorough perusal of this section in order to familiarize yourself with forthcoming alterations scheduled for implementation on the **31st of July, 2023**. {% endhint %} These modifications, primarily encompassing the introduction of supplementary parameters, are anticipated to be of a straightforward nature and aim to enhance the query efficiency of our Fixtures API, thereby affording you considerable advantages.