# GET /v2/teams/{id}

Group: Teams

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.

Plans: Every plan, Free included.

## Parameters

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

## Response

- `data`: `TeamDetail`
- Objects: TeamDetail (https://datasportsapi.com/markdown/reference.md#teamdetail)

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

TypeScript:

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

Python:

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

Go:

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

CLI:

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

## Example response

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

---

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/get/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
