# GET /v2/teams/{id}/squad

Group: Teams

Lists the team’s present roster, giving each player’s profile together with their contract expiry and any ongoing injury.

Plans: Every plan, Free included.

Note: Applies to team sports that keep rosters; a team without one returns an empty array. injury is null unless the player is currently injured, in which case it holds status (out / dayToDay / doubtful / other), description, since, expectedReturn and updatedAt.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | DataSportsAPI team id, a positive integer |

## Response

- `data`: `SquadPlayer[]`
- `meta`: count
- Objects: SquadPlayer (https://datasportsapi.com/markdown/reference.md#squadplayer)

## Errors

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/squad"
```

TypeScript:

```ts
const { data, meta } = await client.teams.squad(id);
```

Python:

```python
res = client.teams.squad(id)
```

Go:

```go
res, err := client.Teams.Squad(ctx, id)
```

CLI:

```bash
$ dsa teams squad <id>
```

## Example response

```json
{ "data": [ { "id": 3801, "name": "Erling Haaland", "position": "forward", "positionCode": "F",
    "jerseyNumber": "9", "heightCm": 195, "preferredFoot": "left", "dateOfBirth": "2000-07-21",
    "country": { "code": "NO", "name": "Norway" }, "marketValue": { "amount": 240000000, "currency": "EUR" },
    "contractUntil": "2034-06-30", "image": "…", "injury": null, … },
    { "id": 3790, "name": "Rodri", …, "injury": { "description": "Hamstring Injury", "status": "out", "since": "2026-10-04",
                                          "expectedReturn": "2026-11-08", "updatedAt": "2026-10-20T09:12:00.000Z" } }, … ],
  "meta": { "count": 25 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/teams/squad/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
