# Squads

This endpoint returns the competition squads for a specific season. 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

## Endpoint URLs

### Squads

1. This allows clients to determine which players are associated to which team and **seasonId -** `https://dde-api.data.imgarena.com/basketball/seasons/{seasonId}/squads`
2. This allows clients to call by **teamId** - `https://dde-api.data.imgarena.com/basketball/squads/{teamId}`

## 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:

| REST Endpoint                           | Frequency         | Description                                                                                              |
| --------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------- |
| `/basketball/seasons/{seasonId}/squads` | Once per 24 hours | Updated on any change to a team and their squad such as a player being called up, a player transfer etc. |

## Required Headers

<table data-header-hidden><thead><tr><th width="244">Key</th><th width="431">Value</th></tr></thead><tbody><tr><td>Key</td><td>Value</td></tr><tr><td>Accept</td><td>application/vnd.imggaming.dde.api+json;version=1</td></tr><tr><td>Content-Type</td><td>application/json</td></tr><tr><td>Authorization</td><td>Bearer eyvhaoudfgpdfgo*</td></tr></tbody></table>

## Response Model

For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:

JSON Schema - <https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/get_basketball_seasons__seasonId__squads>

JSON Schema with value descriptions - <https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/SeasonSquad>