Static Data · Reference

Images & Weather

Cached image proxy for teams, players, managers, leagues and venues. Cut-out face pack. Weather codes used in event responses.

Image proxy

Serve logos and photos through a cached proxy. No authentication required — drop the URL straight into an <img src> tag. Images are cached on disk for 365 days and served with Cache-Control: public, max-age=31536000.

GET https://sports.bzzoiro.com/img/{type}/{id}/

{id} is the internal numeric ID returned in every API response (the id field on team, player, league, etc. objects).

Supported types

type	What it serves	Example URL
`team`	Club crest / logo	`/img/team/35/`
`league`	Competition badge	`/img/league/7/`
`player`	Player portrait	`/img/player/12994/`
`manager`	Head coach portrait	`/img/manager/559/`
`venue`	Stadium / arena photo	`/img/venue/77/`

Transparent background

Append ?bg=transparent to remove the flat white canvas and get a PNG with alpha. The cutout is edge-aware — white inside a logo (text, kit stripes, badge details) is preserved; only the surrounding background is stripped.

GET https://sports.bzzoiro.com/img/{type}/{id}/?bg=transparent

Default	`?bg=transparent`

Transparent variants are cached separately (also 365 days). Photos with a real photographic background are returned unchanged when no flat background is detected.

Code examples

<img src="https://sports.bzzoiro.com/img/team/{{ event.home_team_id }}/" alt="home">  <img src="https://sports.bzzoiro.com/img/player/{{ player.id }}/" style="width:64px;height:64px;border-radius:50%;object-fit:cover" alt="">  <img src="https://sports.bzzoiro.com/img/team/{{ team.id }}/?bg=transparent" alt="">  <img src="https://sports.bzzoiro.com/img/venue/{{ event.venue_id }}/" alt="">

Cut-out player portraits

Player portraits can optionally be served from the sortitoutsi Cut-Out Megapack 2026 — a community face pack (500k+ players) that provides high-quality cut-outs for Football Manager. Add ?sor=true to any /img/player/ URL. If no cut-out exists for that player, the endpoint falls back to the standard portrait silently.

GET https://sports.bzzoiro.com/img/player/{id}/?sor=true Combine with transparent background: GET https://sports.bzzoiro.com/img/player/{id}/?sor=true&bg=transparent

Live example — Martín Zubimendi

Variant	URL	Preview
Standard	`/img/player/966837/`
Cut-out	`/img/player/966837/?sor=true`
Cut-out, no bg	`/img/player/966837/?sor=true&bg=transparent`

Cut-out faces are available for ~11,000 players mapped via Football Manager UIDs. Coverage is best for players active before 2020; newer players fall back to the standard portrait automatically.

Weather codes

Event detail responses (/api/v2/events/{id}/) include a weather object. Its code field maps to this table. weather.description is the same value pre-decoded as a string.

Code	Description
`0`	unknown / closed-roof venue
`1`	clear
`2`	cloudy
`3`	rain
`4`	snow
`5`	extreme

Outdoor stadiums always report at least code 1 when data is available. Closed-roof venues report 0.

Image response codes

Status	When
200 OK	Image found and served (`image/png` or `image/webp`)
404	No image available for that entity (common for older venues and managers)
204 No Content	ID is malformed (e.g. `/img/team/null/`)