Teams and form | Handball API

// Handball API teams and form

Teams and form

Clubs: finding them, their results and fixtures, squads, season figures, form, runs and head to head.

A team is one side of a club, men or women, with its own permanent id (tm_). It keeps that id across every competition it plays in.

Finding one

GET /v1/teams?q=kiel or ?country=de: teams by part of the name or by country, with matches held and dates.
GET /v1/teams/{id}: one team and the competitions it played in.

/results (with season to narrow it) and /fixtures.
GET /v1/matches?team={id}&from=2026-09-01: matches by team, competition, season and dates, finished or scheduled.
/head-to-head?opponent={id}: every meeting of two teams, with the summary from the first team's side.

/squad and /scorers: every player with a line for the team in a season, and the leading scorers.
/stats: the record per competition, home and away, goals a match, form and current run.
/seasons: every season the team played, per competition.
/form?last=10: the last results in every competition, each marked W, D or L.
/streaks: the current run, and the longest winning, unbeaten and losing runs across everything held.

Squads, figures and runs are compiled every night; meta.compiled_at says when.