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 reference

API reference

All 62 endpoints, by section, with the plan each one needs and the MCP tool that calls it (30 tools). Every one answers GET at https://api.handballapi.com with your key in a header; each has a page with its parameters, its fields, a real answer and Try it.

Results 5Matches 4Fixtures 3Competitions 17Teams 11Meta 4Account 1Players 7Referees 4Venues 2Countries 2Stats 2

Results5 endpoints

Finished matches, newest first, paged.

endpointwhat it givesplanMCP tool
GET /v1/results/yesterdayYesterday's resultsFree keyyesterdays_results
GET /v1/results/latestLatest resultsFree keylatest_results
GET /v1/resultsResults on a dayFree keyresults_on_day
GET /v1/results/todayToday's resultsFree keyREST only
GET /v1/results/rangeResults between two daysFree keyREST only

Matches4 endpoints

One match, its player lines and officials, and match search.

endpointwhat it givesplanMCP tool
GET /v1/matches/{id}One matchFree keyget_match
GET /v1/matches/{id}/playersPlayer lines of a matchResultsmatch_players
GET /v1/matchesFind matchesResultssearch_matches
GET /v1/matches/{id}/officialsOfficials of a matchFree keymatch_officials

Fixtures3 endpoints

Matches still to be played, soonest first.

endpointwhat it givesplanMCP tool
GET /v1/fixturesFixtures aheadFree keyfixtures
GET /v1/fixtures/todayToday's fixturesFree keyREST only
GET /v1/fixtures/tomorrowTomorrow's fixturesFree keyREST only

Competitions17 endpoints

Leagues and cups: seasons, tables, leaders, form, figures and records.

endpointwhat it givesplanMCP tool
GET /v1/competitions/{id}/tableLeague tableResultsleague_table
GET /v1/competitions/{id}/scorersTop scorersResultstop_scorers
GET /v1/competitionsCompetitionsFree keyfind_competitions
GET /v1/competitions/{id}One competitionFree keyREST only
GET /v1/competitions/{id}/seasonsSeasons of a competitionFree keycompetition_seasons
GET /v1/competitions/{id}/resultsResults of a competitionFree keyREST only
GET /v1/competitions/{id}/fixturesFixtures of a competitionFree keyREST only
GET /v1/competitions/{id}/teamsTeams of a competitionFree keyREST only
GET /v1/competitions/{id}/goalkeepersGoalkeepers of a seasonResultstop_goalkeepers
GET /v1/competitions/{id}/seven-metres7m takers of a seasonResultsREST only
GET /v1/competitions/{id}/disciplineDiscipline of a seasonResultsREST only
GET /v1/competitions/{id}/assistsAssists of a seasonResultsREST only
GET /v1/competitions/{id}/home-awayHome and away tablesResultshome_away_table
GET /v1/competitions/{id}/formForm tableResultsleague_form
GET /v1/competitions/{id}/statsSeason figuresResultsseason_stats
GET /v1/competitions/{id}/recordsSeason recordsResultsREST only
GET /v1/competitions/{id}/attendanceCrowds of a seasonResultsREST only

Teams11 endpoints

Clubs: results, fixtures, squads, figures, form and runs.

endpointwhat it givesplanMCP tool
GET /v1/teams/{id}/head-to-headHead to headResultshead_to_head
GET /v1/teamsFind teamsFree keyfind_teams
GET /v1/teams/{id}One teamFree keyREST only
GET /v1/teams/{id}/resultsResults of a teamFree keyteam_results
GET /v1/teams/{id}/fixturesFixtures of a teamFree keyteam_fixtures
GET /v1/teams/{id}/squadSquad of a seasonResultsteam_squad
GET /v1/teams/{id}/statsSeason figures of a teamResultsteam_stats
GET /v1/teams/{id}/formForm of a teamResultsteam_form
GET /v1/teams/{id}/scorersScorers of a teamResultsREST only
GET /v1/teams/{id}/seasonsSeasons of a teamResultsREST only
GET /v1/teams/{id}/streaksRuns of a teamResultsREST only

Meta4 endpoints

What the archive holds, seasons, and what changed.

endpointwhat it givesplanMCP tool
GET /v1/meta/coverageCoverageFree keycoverage
GET /v1/meta/completenessCompletenessFree keyREST only
GET /v1/meta/seasonsSeasons heldFree keyREST only
GET /v1/updatesChanged sinceResultsREST only

Account1 endpoints

Your key, checking itself.

endpointwhat it givesplanMCP tool
GET /v1/usageYour usageFree keyREST only

Players7 endpoints

Players: match logs, seasons, careers and leaders.

endpointwhat it givesplanMCP tool
GET /v1/players/leadersLeadersResultsplayer_leaders
GET /v1/playersFind playersFree keyfind_players
GET /v1/players/{id}One playerFree keyREST only
GET /v1/players/{id}/matchesMatches of a playerResultsREST only
GET /v1/players/{id}/seasonsSeasons of a playerResultsREST only
GET /v1/players/{id}/careerCareer of a playerResultsplayer_career
GET /v1/goalkeepers/leadersGoalkeeper leadersResultsREST only

Referees4 endpoints

Referees: their matches and their record.

endpointwhat it givesplanMCP tool
GET /v1/refereesFind refereesFree keyfind_referees
GET /v1/referees/{id}One refereeFree keyREST only
GET /v1/referees/{id}/matchesMatches of a refereeResultsREST only
GET /v1/referees/{id}/statsRecord of a refereeResultsreferee_stats

Venues2 endpoints

Halls and the matches played in them.

endpointwhat it givesplanMCP tool
GET /v1/venuesFind venuesFree keyREST only
GET /v1/venues/{id}/matchesMatches at a venueResultsREST only

Countries2 endpoints

Every country held and its competitions.

endpointwhat it givesplanMCP tool
GET /v1/countriesCountriesFree keyREST only
GET /v1/countries/{code}/competitionsCompetitions of a countryFree keyREST only

Stats2 endpoints

League-wide figures: home advantage, half-time and full-time.

endpointwhat it givesplanMCP tool
GET /v1/stats/home-advantageHome advantageResultshome_advantage
GET /v1/stats/half-time-full-timeHalf-time and full-timeResultsREST only