---
title: Teams, players & transfers
description: Team profiles, squads and fixtures; player search, bios, per-match stats, careers; the global transfers feed and World Cup squads.
badge: free
---

# Teams, players & transfers

## Teams

```
GET /api/v2/teams/
```

| Param | Type | Description |
|---|---|---|
| `country_code` | string | ISO country code, e.g. `AR` |
| `league_id` / `season_id` | int | Teams competing in a league/season |
| `in_competition` | bool | Only teams currently in an active competition |
| `is_women` | bool | Women's teams |
| `name` | string | Name search |
| `limit` / `offset` | int | Pagination |

```
GET /api/v2/teams/{id}/           # profile: venue, coach, colours, country
GET /api/v2/teams/{id}/squad/     # current squad grouped by position
GET /api/v2/teams/{id}/fixtures/  # date_from, date_to, league_id, status
GET /api/v2/teams/{id}/social/    # curated tweets/videos (type filter)
```

```bash
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sports.bzzoiro.com/api/v2/teams/755/fixtures/?status=upcoming&limit=5"
```

## Players

```
GET /api/v2/players/
```

| Param | Type | Description |
|---|---|---|
| `name` | string | Name search |
| `team_id` | int | Current club |
| `national_team_id` | int | Current national-team squad |
| `nationality_code` | string | ISO code, e.g. `AR` |
| `position` | string | `G` · `D` · `M` · `F` |
| `limit` / `offset` | int | Pagination |

```
GET /api/v2/players/{id}/                # bio, market value, skills
GET /api/v2/players/{id}/stats/          # per-match log — season_id, team_id, league_id, date_from/to
GET /api/v2/players/{id}/transfers/      # transfer history with fees
GET /api/v2/players/{id}/career/         # season-by-season summary
GET /api/v2/players/{id}/national-team/  # international record
GET /api/v2/players/{id}/social/         # tweets/videos
```

The full workflow with examples:
[Get a football player profile](/docs/guides/football-player-profile/).

## Transfers feed

```
GET /api/v2/transfers/
```

| Param | Type | Description |
|---|---|---|
| `player_id` | int | One player's transfer history |
| `team_id` | int | In **or** out of this club |
| `from_team_id` / `to_team_id` | int | Direction-specific |
| `date_from` / `date_to` | date | Transfer date window |
| `min_fee` | int | Minimum fee (EUR) |
| `has_fee` | bool | Only transfers with a disclosed fee |
| `ordering` | string | Sort field, prefix `-` for descending |

> **Note:** the dataset includes forward-dated moves (announced loans/returns
> that haven't happened yet). For a "latest transfers" widget, always cap
> `date_to` at today.

## World Cup squads

```
GET /api/v2/worldcup/squads/              # team, group, status, has_player
GET /api/v2/worldcup/squads/{team_id}/
```

Tournament squad lists with per-player status — built for tournament hub
pages.

## Images

Badges and photos come from ids, no extra calls:
`/img/team/{id}/`, `/img/player/{id}/?sor=true&bg=transparent` — see
[Working with images](/docs/guides/images/).