> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> Full team profile — squad, trophies, injuries, salary, matches, month matches, transfers, and related teams

All team endpoints accept an optional `?sport={slug}` (default `football`) and, where relevant, `?tz=±HH:MM`.

## Team Detail (Full)

```text theme={null}
GET /api/v1/team/{teamId}?sport=football
```

Returns the complete team payload — players, matches, table row, totals, injuries, honors, lineups, goal distribution, related teams, venues, manager, market value.

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/team/5xvkjoiyyyix793"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/team/5xvkjoiyyyix793"
  ```
</CodeGroup>

```json theme={null}
{
  "success": true,
  "team": {
    "id": "5xvkjoiyyyix793",
    "name": "Real Madrid",
    "venue":   { "name": "Santiago Bernabéu Stadium" },
    "manager": { "name": "Carlo Ancelotti" },
    "country": { "name": "Spain" },
    "marketValue": "€ 1.219B",
    "totalPlayers": 40,
    "foundationTime": "1902",
    "slug": "real-madrid"
  }
}
```

## Team Squad

```text theme={null}
GET /api/v1/team/{teamId}/squad
```

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/team/5xvkjoiyyyix793/squad"
```

## Team Trophies

```text theme={null}
GET /api/v1/team/{teamId}/trophies
```

Returns honor types with per-season items (e.g. Real Madrid → 21 honor types including Champions League, La Liga).

## Team Injuries

```text theme={null}
GET /api/v1/team/{teamId}/injuries
```

```json theme={null}
{
  "success": true,
  "injuries": [
    { "player": { "id": "...", "pid": 101330 }, "type": 1, "reason": "Knee injury", "startTime": 1772467200 }
  ]
}
```

## Team Salary

```text theme={null}
GET /api/v1/team/{teamId}/salary
```

## Team Matches

```text theme={null}
GET /api/v1/team/{teamId}/matches?sport=football&tz=00:00
```

## Team Month Matches (with Names)

```text theme={null}
GET /api/v1/team/{teamId}/month-matches?sport=football&tz=00:00
```

Like `/matches` but **fully hydrated** — returns `matches[]`, `teams[]`, `competitions[]`, and `venues[]` arrays so you don't need follow-up calls.

## Team Transfers

```text theme={null}
GET /api/v1/team/{teamId}/transfers
```

<Warning>
  May return an empty payload for smaller teams.
</Warning>

## Related Teams

```text theme={null}
GET /api/v1/team/{teamId}/map
```

Returns the top 20 globally popular teams (Real Madrid, Barcelona, Bayern Munich, …) — useful for "you may also like" surfaces.

**Cache TTL:** 10 minutes for all team endpoints.