Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Squad

GET

/v2/teams/{id}/squad

All plans

View as MarkdownTry in Playground →

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

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

id

pathrequired

DataSportsAPI team id, a positive integer

Response

meta
count

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/squad"
Example
{ "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 } }