Latest
DEHG Hamburg-Barmbek4129SV 04 Plauen-OberlosaDETSG 1893 Leihgestern27401.FC KölnESUneatlantico Pereda3132Cicar Lanzarote Ciudad de ArrecifeES3COM Squad Valsequillo2342Oliveira & Faro Saeplast CañizaHROsijek2524Metković-MehanikaCZHandball Třeboň3221Házená RokycanyCZSK Žeravice2726SK UP Olomouc, z.s.SIRK SVIŠ Cugelj Okna Ivančna Gorica2935RK Celje Pivovarna LaškoSIŽRK Krka Novo Mesto2529ŽRK VelenjeRSLoznica3534Šamot 65

Handball Data API

Handball, read to the last line.
Every match sheet, every season.

Final and half-time scores, venues and referees, and a line for every player and goalkeeper, from leagues in ten countries and IHF events. Read after the final whistle, joined up across seasons, served as JSON.

Get a free key →Read the docs50 calls a day free. Paid from $19 a month, pricing.
The game, and what we record01
12345
1
6 m goal areaOnly the goalkeeper may stand in it. Saves and shots faced are kept for every keeper.
2
9 m lineFree throws are taken from here, the attack builds along it.
3
Two halves of 30 minutesFinal and half-time score on every match, extra time and shoot-outs where played.
4
7 m throwThe handball penalty. Scored and taken, per player.
5
Seven a sideSix on court and a keeper. Goals, two-minute suspensions and cards on each player line.
40 × 20 mCourt
2 × 30Minutes
7A side
3 × 2 mGoal
Latest match sheet02
HG Hamburg-Barmbek4129SV 04 Plauen-Oberlosa
3. Liga Männer, Nord-Ost  /  HT 21-17  /  Full time
NoHG Hamburg-BarmbekG7mSv
87Ben Rune Behncke10
9Connor Scharnweber72/2
47Michael Kühn7
23Justin Kaminski6
How it works03
  1. ReadOfficial league and federation results, after the final whistle. Not in play.
  2. JoinOne id per team and player, kept across seasons and spellings.
  3. KeepEvery season held, back to 2004. Nothing overwritten.
  4. ServeREST and an MCP server. UTC times, local zone alongside.
Goals per match, by country04
Turkey64.1
Denmark59.0
Slovakia57.9
Slovenia56.6
Czech Republic56.1
Croatia55.6
Worked out from every match we hold.
The archive05
69,349Matches
28.3%Keeper save rate
41,974Keeper lines
2004First season
2004Matches held, by season2026
02
The results, and the call behind them

Every row below is one match from the API. Filter it and the request beside it changes with you; open a row to see what else the match sheet carries.

0matches  /  0goals
Date, league↓HomeScore↕AwayHalvesDepth↕Open
ResultsPlayer linesKeepers tooHalves: first and second half, winner of each in white
03
Coverage, season by season

Every country we hold, men and women apart, one cell per season. The brighter the cell, the more matches in it; switch to player lines to see how deep each season goes.

0rows  /  0matches
Season shown by its first year. The last column is the season in progress.Full coverage table→
04
Anatomy of a match sheet

Five layers make up every match we hold. Step through them, or let them run: the sheet lights up the part each layer covers, and the response shows the fields you get back.

  1. 01Match

    The fixture itself: id, date and throw-off in UTC with the local time zone, competition, venue, crowd and the referees.

    iddate_utckickoff_localtimezonevenuereferees
  2. 02Score

    Final score and half-time on every match. The second half falls out of the two; seven-metre shoot-outs where played.

    statusgoalshtshootout
  3. 03Teams

    One id per club, kept across seasons, sponsors and spellings, with the name as it was printed that season.

    team_idname
  4. 04Player lines

    A line for each player: shirt number, goals, seven-metre throws scored and taken, two-minute suspensions and cards.

    shirtgoalsseven_m_goalstwo_minyellow
  5. 05Goalkeepers

    Saves and shots faced for each keeper, so save rates hold up across a match, a season or a career.

    savesshots_facedsave_rate
3. Liga Männer, Nord-Ost  /  13
Saturday 21 November 2026, 21:00 local
SPORTHALLE WANDSBEK / Referees Jan Krüger, Michael Engelland, Sönke Marxen, Sven Levermann, Christian Rietenberg
mt_5setkwaz
20:00 UTC
HG Hamburg-Barmbek4129SV 04 Plauen-Oberlosa
Half-time21-17Second half20-12StatusFull time
HG Hamburg-Barmbekhome
NoPlayerG7m2′C
87Ben Rune Behncke10
9Connor Scharnweber72/2
47Michael Kühn7
23Justin Kaminski6
2Frederic Stüber3
17Timon Kaminski3
10 others5
SV 04 Plauen-Oberlosaaway
NoPlayerG7m2′C
4Matevz Kunst71/22′2′
14Philip Trommer-Ernst4
33Roman Becvar4
7Libor Hanisch3
11Franz Häcker3
3Tim Stäglich2
10 others6
One match, one callGET /v1/matches/mt_5setkwaz
05
Ask it in plain English

The same data through our MCP server, so Claude, ChatGPT or any MCP client can answer handball questions from the real match sheets, and show the call it made.

Example conversation, Handball API connected
Ask about any league, team, player or season→
  1. 01
    Get a free keyOne click, no card. The free key works with MCP too.
  2. 02
    Add the serverPaste this address into your assistant's connector settings.
    https://handballapi.com/mcp
  3. 03
    AskLeagues, teams, players, keepers, seasons. Every answer comes from a real call you can see.
Tools the server offers
latest_resultsThe latest final scores, newest first
get_matchOne match: score, half-time, venue, referees
match_playersEvery player line, keepers included
league_tableA league table built from the results
top_scorersThe leading scorers of a season
head_to_headEvery meeting between two teams

Works with Claude, ChatGPT and any client that speaks the Model Context Protocol. Calls count against your key's daily limit like any other.

07
Priced by how far back you need

Every plan uses the same endpoints and the same fields. Paid plans reach further back and call more often. Cancel any time.

Two months free
Which plan
Set your use and we point to the plan
Fits your useResults
Free key
$0forever
No card needed
  • 50 calls a day, 10 a minute
  • Yesterday and today
  • Results, fixtures and one-match details
  • Coverage counts for every league
  • MCP server for your assistant
Get a free key →
Results
$19a month
For apps and this season
  • 5,000 calls a day, 60 a minute
  • This season and last
  • Player lines and goalkeepers
  • League tables, top scorers, head to head
  • MCP server, same limits
Choose Results →
Archive
$49a month
For models and history
  • 25,000 calls a day, 120 a minute
  • Every season, back to 2004
  • Every endpoint and every field
  • Head to head across every season
  • MCP server, same limits
Choose Archive →
What you getFree keyResultsArchive
Calls a day505,00025,000
Calls a minute1060120
HistoryYesterday and todayThis season and lastEvery season, back to 2004
Results and fixtures
One match: venue, crowd, referees
Player lines and goalkeepers
League tables
Top scorers
Head to head
MCP server
Prices in US dollars. Card charges appear as DEVELOPERDATA.NET.Billing questions: developerdata.net/support
08
Questions, answered

The short answers people ask for before they take a key.

Not here? Write to [email protected]

No. Every match is read after the final whistle, from the official result. You get final and half-time scores, player lines and keepers, not minute-by-minute events.

From the results that leagues and federations publish openly. We read them, check them and join them up so a team or player keeps one id across every season.

Leagues in several countries, men and women, plus IHF championships. The coverage section and the full coverage table show the first season and match count for every league.

Yes. One id per club and per player, kept across seasons, sponsor names and spellings, with the name as it was printed each season alongside.

Every request counts as one, whether it comes through the REST API or a tool call through the MCP server. Daily allowances reset at 00:00 UTC, and the usage endpoint shows where you stand without counting.

Further calls get a 429 reply with a Retry-After header saying when to try again. Nothing extra is charged, and you can move up a plan at any time.

Results, fixtures and one-match details for yesterday and today. Player lines, tables, top scorers and head to head are on the paid plans, which also reach further back.

Yes, from your account. A cancelled plan runs to the end of the period you paid for, then your key returns to the free key. Moving to yearly takes effect at your next renewal.

As DEVELOPERDATA.NET. Billing questions go to developerdata.net/support.

JSON over HTTPS, with ids that stay the same, times in UTC and the league's own time zone alongside.

Add the MCP address shown above as a connector in Claude, ChatGPT or any MCP client and use your key. The assistant shows each call it makes.

Write to [email protected] with your key prefix and what you called, and we will look into it.

09
Running, and up to date

Each part checked every minute by our monitor, and how recently every country last took in a result.

WebsiteRunning
handballapi.com
99.86%Up, last 30 days
564 msReply time
Up since5 Nov 2026, 08:11 UTC
APIRunning
REST, every endpoint
99.86%Up, last 30 days
555 msReply time
Up since5 Nov 2026, 08:11 UTC
MCP serverRunning
handballapi.com/mcp
99.53%Up, last 30 days
244 msReply time
Up since5 Nov 2026, 08:11 UTC
CountryLast result inNext match
DEGermanyJust nowSun 22 Nov
ESSpain10 h agoSun 22 Nov
HRCroatia10 h agoSun 22 Nov
RSSerbia10 h agoSun 22 Nov
SISlovenia10 h agoSun 22 Nov
CZCzech Republic11 h agoSun 22 Nov
DKDenmark14 h agoSun 22 Nov
TRTurkey15 h agoSun 22 Nov
SESweden1 day agoBetween seasons
SKSlovakia6 days agoSun 22 Nov
IHFInternational8 days agoMon 23 Nov
CHSwitzerland20959 days agoBetween seasons
Incidents, last 14 days
Today
All services runningNo incidents in the last 14 days.