Team

GET

https://api.datasportsapi.com/v2/teams/{id}

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: TeamDetail

Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, present for roughly half of all teams).

Individual competitors that the source profiles (tennis, MMA) also get person: nickname, date of birth, height, weight, reach and weight class, with tennis adding birthplace, residence, handedness (right / left / ambidextrous), turnedPro (a year) and prize money for the current season and the whole career (Money).

MMA and boxing fighters additionally carry record: their career win-draw-loss tally plus their latest fights and how each one was decided.

01Parameters

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

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}"

03Response

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

data: TeamDetail

ObjectsTeamDetail

Example response

19 lines

{ "data": { "id": 3758, "name": "Arsenal", "slug": "arsenal", "shortName": "Arsenal", "code": "ARS",
    "image": "https://cdn.datasportsapi.com/v2/teams/3758/logo", "sport": "football",
    "country": { "code": "EN", "name": "England" },
    "venue": { "id": 157878, "name": "Emirates Stadium", "city": "London",
               "country": { "code": "EN", "name": "England" }, "capacity": 60704 },
    "colors": { "primary": "#cc0000", "secondary": "#ffffff", "text": "#ffffff" },
    "gender": "male", "national": false, "kind": "team",
    "manager": { "id": 794942, "name": "Mikel Arteta", "slug": "mikel-arteta", "shortName": "M. Arteta",
                 "image": "https://cdn.datasportsapi.com/v2/managers/794942/photo" }, "person": null, "record": null, "foundedOn": "1886-12-01" } }

// A tennis player:
    "kind": "individual", "manager": null,
    "person": { "dateOfBirth": "2001-08-16", "heightCm": 191, "weightKg": 77, "reachCm": null, "nickname": null, "weightClass": null,
                "birthplace": "San Candido, Italy", "residence": "Monte Carlo, Monaco", "handedness": "right", "turnedPro": 2018,
                "prizeMoneySeason": { "amount": 14520000, "currency": "USD" }, "prizeMoneyCareer": { "amount": 52310000, "currency": "USD" } }

// An MMA fighter (career record — not the per-competition figure of /v2/fixtures/{id}/form):
    "record": { "wins": 28, "draws": 0, "losses": 4,
                "recent": [ { "result": "win", "method": "unanimousDecision" }, …, { "result": "loss", "method": "ko" } ] }

04Errors

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

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code