Leagues, seasons and teams

Everything starts from a league. A league is any competition: a national league at any level, a cup, a junior or women's league, a friendly series or an international tournament. Each has its country, level, age group, gender and kind, and says what it holds in coverage: box_scores, part_box_scores, scores_and_odds or scores_only.

Leagues

• Find one: GET /v1/leagues?q=extraliga, or by country, kind, gender, age or coverage.
• One league: GET /v1/leagues/{league_id}, with its number of seasons and games, its latest season and coverage_detail: how many finished games have a box score and odds, and how often the start time, the rink and the crowd are known.
• Every country with its leagues and teams: GET /v1/countries.

Seasons

• A league's seasons, newest first: GET /v1/leagues/{league_id}/seasons, each with its first and last game dates and its games.
• One season: GET /v1/seasons/{season_id}; its games: /v1/seasons/{season_id}/games.
• The table built from the results: /standings; the playoff series: /playoffs; the leading players: /leaders; the season in numbers: /summary; the teams in it: /teams.

Seasons are labelled the way the league labels them: 2026-27 for a season over two years, 2026 for one in a single year.

Teams

• Find one: GET /v1/teams?q=, or the teams of a league or season with league_id or season_id.
• One team: GET /v1/teams/{team_id}, with every league it has played in and when.
• Its games: /v1/teams/{team_id}/games; its record season by season: /seasons; who dressed for it: /roster?season_id=; its numbers in a season: /stats?season_id=; every meeting with another team: /head-to-head/{other_id}.
• Every team that has played in a league, most recent first: GET /v1/leagues/{league_id}/teams.

A team that moved or changed its name keeps one id, and each game shows the name it had then.