Sign inGet a free key →
DenmarkHerreligaen1. DivisionBambuni KvindeligaenSwedenHandbollsliganHandbollsligan, womenSloveniaLiga NLB1. SRL, womenGermany3. Liga3. Liga, womenSlovakiaNiké Handball ExtraligaHandball ExtraligaDoprastav Liga, womenSerbiaARKUS ligaARKUS liga, womenSpainDivision de Honor Plata, womenLiga Guerreras Iberdrola, womenDivisión de Honor PlataCroatiaPremijer ligaCzech Republic2. liga, women1. liga, womenMOL Liga, womenTurkeySüper LigSüper Lig, womenInternationalWorld ChampionshipsJunior and youth championships
Men and women, results back to 2004Full coverage table→

// Handball API results

Results

Finished matches by day, by the last few days or yesterday, filtered by country, and how to walk a busy day.

A result is a match that is over: finished, or awarded when it was given at the table. Matches appear after full time and never during play.

Three calls find them:

  • GET /v1/results/yesterday: every match finished yesterday (UTC). The call to run each morning.
  • GET /v1/results/latest?days=3: the last 1 to 7 days, newest first. Good for catching up after a gap.
  • GET /v1/results?date=2026-10-04: one whole UTC day, every league.

All three take country (one of the codes in Coverage) and page with per_page, page or cursor (Pagination).

Each row carries the match id (mt_), its date_utc, the competition with its own id (cp_), name, country and season, and the home and away sides with team_id (tm_), name, goals and ht, the goals at half-time where the source published them, else null.

Common jobs

  • A nightly import: call results/yesterday once a day and store rows by id. Ids never change, so a second run is safe.
  • A league table: collect a competition's results by competition.id and season; two points a win and one a draw is the usual handball count.
  • A team's form: filter stored rows by team_id on either side, newest first.

The free key reaches yesterday and today; older dates are on the paid plans (Plans and limits).

PreviousErrorsNextMatches