Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Team

GET

/v2/teams/{id}

All plans

View as MarkdownTry in Playground →

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.

Parameters

id

pathrequired

DataSportsAPI team id, a positive integer

Response

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}"
Example
{ "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" } ] }