Skip to content
datasportsAPI

TeamsSquad

Documentation

/

Type to filter the docs by title or path.

TeamsEndpoint 33 of 116

Squad

GET

/v2/teams/{id}/squad

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
SquadPlayer[]
Try in Playground

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

Worth knowing

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.

01Parameters

  • idpathRequired

    DataSportsAPI team id, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

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

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
SquadPlayer[]
meta
count
ObjectsSquadPlayer
Example response
{ "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 } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code