Squads

The Squads API lets developers list and manage all players registered to a squad within a given competition.

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

List season squads

GET https://dde-api.data.imgarena.com/v2/tabletennis/seasons/{seasonId}/squads

Retrieves a list of players associated to certain teams.

Path Parameters

Name	Type	Description
sport*	String	tabletennis
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

400: Bad Request

{
    Request is missing required HTTP header 'Accept'
}

401: Unauthorized

200: OK

List team squads

GET https://dde-api.data.imgarena.com/tabletennis/squads/{teamId}

Path Parameters

Name	Type	Description
sport*	String	tabletennis
teamId*	UUID	unique id of a requested team

200: OK

     {
            "id": "5c654ea3-9aee-4043-9ea5-565ac70748d0",
            "season": {
                "id": "ff88b9c6-6598-4d05-88c5-c87751e64380",
                "name": "reg"
            },
            "team": {
                "id": "e0f1602c-07f7-41bd-a635-fa8700c58c51",
                "name": "ALAMIYAN Noshad"
            },
            "players": [
                {
                    "id": "a0d59351-c3a9-485a-bd9a-2415efa9d3b2",
                    "fullName": "Noshad ALAMIYAN",
                    "firstName": "Noshad",
                    "lastName": "ALAMIYAN",
                    "location": {
                        "name": "Iran",
                        "country": {},
                        "continent": {
                            "name": "Asia"
                        }
                    },
                    "verified": true
                }
            ]
        }

400: Bad Request

401: Unauthorized

Response fields

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 page.

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 Squads API, thereby affording you considerable advantages.