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

Endpoints

List season squads

GET https://dde-api.data.imgarena.com/cricket/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

{
    Request is missing required HTTP header 'Accept'
}

List team squads

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

Path Parameters

Name
Type
Description

teamId*

UUID

unique id of a requested team

[
    {
        "id": "124656ac-4c90-4132-8104-91c655146fd7",
        "season": {
            "id": "0e715382-7f7d-4ee0-a136-eea0530f8d5b",
            "name": "2023"
        },
        "team": {
            "id": "4470aae0-60df-4cee-b6bd-f0c1c9177705",
            "name": "England"
        },
        "players": [
            {
                "id": "69919a04-3611-4727-9d0c-9f27a96717f7",
                "fullName": "Ollie Pope",
                "firstName": "Ollie Pope",
                "shirtNumber": "6",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "0c9a4d5d-3427-499b-aec7-7fd6c624ee81",
                "fullName": "Joe Root",
                "firstName": "Joe Root",
                "shirtNumber": "9",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "7477781e-16b4-4363-b874-e362d46b39a7",
                "fullName": "Stuart Broad",
                "firstName": "Stuart",
                "lastName": "Broad",
                "shirtNumber": "2",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "c9c2deda-02c8-4452-97af-2bbbb4224f55",
                "fullName": "Zak Crawley",
                "firstName": "Zak",
                "lastName": "Crawley",
                "shirtNumber": "4",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "9baaab13-fb26-4eb8-bb68-3165e0a26f78",
                "fullName": "Harry Brook",
                "firstName": "Harry",
                "lastName": "Brook",
                "shirtNumber": "7",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "48b14a72-d18f-40b0-a892-a0c691efc092",
                "fullName": "James Anderson",
                "firstName": "James",
                "lastName": "Anderson",
                "shirtNumber": "1",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "7cfa647d-3bd6-4f04-9306-28858a0fb21d",
                "fullName": "Jack Leach",
                "firstName": "Jack",
                "lastName": "Leach",
                "shirtNumber": "8",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "f0d11b2d-dc34-41de-9ad5-b77f98e35ec3",
                "fullName": "Ben Duckett",
                "firstName": "Ben",
                "lastName": "Duckett",
                "shirtNumber": "10",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "a72257bc-984e-4e33-a012-a173a44aa527",
                "fullName": "Bob Jones",
                "firstName": "Bob",
                "lastName": "Jones",
                "shirtNumber": "12",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": false
            },
            {
                "id": "ba28ca36-5a9f-4322-a2c0-a11e450432f0",
                "fullName": "Ollie Robinson",
                "firstName": "Ollie",
                "lastName": "Robinson",
                "shirtNumber": "11",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "0a60f75d-a9fd-48c4-8ff2-8e6c8b159f9b",
                "fullName": "Ben Stokes",
                "firstName": "Ben",
                "lastName": "Stokes",
                "shirtNumber": "3",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": true
            },
            {
                "id": "4f3916d3-1956-4cc3-b77f-52cd7af78cbf",
                "fullName": "Bill Smith",
                "firstName": "Bill",
                "lastName": "Smith",
                "shirtNumber": "16",
                "location": {
                    "country": {},
                    "continent": {}
                },
                "verified": false
            }
        ]
    }
]
```

Response fields

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

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.

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.

PreviousFixturesNextActions

Last updated