// Handball API competitions and seasons

A competition is a league or a cup in one country, with its own permanent id (cp_). Its kind is league or cup; a cup is played as knockout and has no table.

Finding one

• GET /v1/competitions?country=de&gender=women: every competition with results, filtered by country, men or women, or part of the name (q).
• GET /v1/countries/{code}/competitions: the same for one country, the busiest first.
• GET /v1/competitions/{id}: one competition, with its latest season.
• GET /v1/competitions/{id}/seasons: every season held, with matches, teams, dates and how many matches carry player lines.

A season

Every call below takes season (such as 2025/26); without it, the latest season with results is used.

• Results and fixtures: /results and /fixtures.
• The clubs: /teams.
• Tables: /table overall, /home-away for home and away matches apart, and /form for each team's last five and current run. Two points a win and one a draw, ordered by points, goal difference and goals scored.
• Players: /scorers, /goalkeepers (save rates, with min_shots), /seven-metres, /assists (where the league publishes them) and /discipline.
• The season in figures: /stats (goals a match, home and away goals, home win, draw and away win rates, average crowd), /records (biggest win, highest and lowest scoring, largest crowd) and /attendance (crowds by home team).

Tables, form, figures and leaders are compiled every night from the results and player lines held; their meta.compiled_at says when.