---
title: Managers, referees & venues
description: Coach profiles with tactical style, referee records with card averages, and stadium data.
badge: free
---

# Managers, referees & venues

## Managers

```
GET /api/v2/managers/
```

| Param | Type | Description |
|---|---|---|
| `name` | string | Name search |
| `team_id` | int | Current club |
| `league_id` | int | Managers active in a league |
| `nationality_code` | string | ISO code |
| `tactical_profile` | string | Style classification filter |
| `team_style` | string | Team-style classification filter |
| `min_matches` | int | Minimum matches managed |
| `limit` / `offset` | int | Pagination |

```
GET /api/v2/managers/{id}/          # profile: preferred formation, style, record
GET /api/v2/managers/{id}/career/   # clubs managed, spells, win rates
GET /api/v2/managers/{id}/matches/  # match log — date_from/to, league_id, team_id, status
GET /api/v2/managers/{id}/social/   # curated media
```

```bash
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/managers/?league_id=85&min_matches=50"
```

## Referees

```
GET /api/v2/referees/
```

| Param | Type | Description |
|---|---|---|
| `name` | string | Name search |
| `country_code` | string | ISO code |
| `league_id` | int | Referees active in a league |
| `min_matches` | int | Minimum matches officiated |
| `limit` / `offset` | int | Pagination |

```
GET /api/v2/referees/{id}/          # profile + per-match aggregates (cards, fouls, penalties)
GET /api/v2/referees/{id}/matches/  # match log — date_from/to, league_id, season_id, status
```

Referee aggregates (yellow/red cards per match) are the data behind
cards-market research — combine with the
[odds feed](/docs/football/odds-predictions/) `total_red_cards` market.

## Venues

```
GET /api/v2/venues/
```

| Param | Type | Description |
|---|---|---|
| `name` | string | Name search |
| `country_code` | string | ISO code |
| `city` | string | City filter |
| `min_capacity` | int | Minimum capacity |
| `team_id` | int | Home venue of a team |
| `limit` / `offset` | int | Pagination |

```
GET /api/v2/venues/{id}/                # capacity, city, coordinates, home team
GET /api/v2/venues/{id}/competitions/   # competitions hosted at this venue
```

Venue photos: `/img/venue/{id}/` — see [Working with images](/docs/guides/images/).