Growing Discord community β€” direct access to the developer, live coverage & picks. Join now β†’

Static data

Reference assets that don't change on a per-request basis: the cached image proxy and the weather-code dictionary used in event detail responses.

Images

Serve logos and photos for teams, players, managers, leagues, and venues through a cached proxy. No authentication required β€” the image endpoint is public so you can drop the URL directly into <img src> tags.

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

{id} is the internal ID β€” the id field returned by every API response. Images are cached on disk for 365 days and served with Cache-Control: public, max-age=31536000, so repeated requests are instant.

Supported types
typeSource fieldExamplePreview
teamTeam logo / crest/img/team/35team logo
leagueCompetition badge/img/league/7league badge
playerPlayer portrait/img/player/12994player
managerHead coach portrait/img/manager/559manager
venueStadium/arena photo/img/venue/77venue
Examples
<!-- Team logo from a match response -->
<img src="https://sports.bzzoiro.com/img/team/{{ event.home_team_id }}/" alt="home logo">

<!-- Player portrait, rounded -->
<img src="https://sports.bzzoiro.com/img/player/{{ player.id }}/"
     style="width:64px;height:64px;border-radius:50%;object-fit:cover" alt="">

<!-- Venue photo on the match detail page -->
<img src="https://sports.bzzoiro.com/img/venue/{{ event.venue_id }}/" alt="">
Responses: 200 OK with image/png or image/webp when available Β· 404 when no image is available for that entity (common for some venues and older managers) Β· 204 No Content when the ID is malformed (e.g. /img/team/null/).
Weather codes

Event detail responses (/api/v2/events/{id}/) include a weather object whose code field maps to this dictionary. weather.description is the same mapping pre-decoded for clients that only need the label.

CodeDescription
0unknown / closed venue
1clear
2cloudy
3rain
4snow
5extreme

Unknown / closed-roof venues report code 0; outdoor stadiums always report at least 1 when data is available.