Handball Data API
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.
- ReadOfficial league and federation results, after the final whistle. Not in play.
- JoinOne id per team and player, kept across seasons and spellings.
- KeepEvery season held, back to 2004. Nothing overwritten.
- ServeREST and an MCP server. UTC times, local zone alongside.
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.
| Date, league↓ | Home | Score↕ | Away | Halves | Depth↕ | Open |
|---|
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.
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.
- 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 - 02Score
Final score and half-time on every match. The second half falls out of the two; seven-metre shoot-outs where played.
statusgoalshtshootout - 03Teams
One id per club, kept across seasons, sponsors and spellings, with the name as it was printed that season.
team_idname - 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 - 05Goalkeepers
Saves and shots faced for each keeper, so save rates hold up across a match, a season or a career.
savesshots_facedsave_rate
20:00 UTC
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.
- 01Get a free keyOne click, no card. The free key works with MCP too.
- 02Add the serverPaste this address into your assistant's connector settings.
https://handballapi.com/mcp - 03AskLeagues, teams, players, keepers, seasons. Every answer comes from a real call you can see.
latest_resultsThe latest final scores, newest firstget_matchOne match: score, half-time, venue, refereesmatch_playersEvery player line, keepers includedleague_tableA league table built from the resultstop_scorersThe leading scorers of a seasonhead_to_headEvery meeting between two teamsWorks with Claude, ChatGPT and any client that speaks the Model Context Protocol. Calls count against your key's daily limit like any other.
Each gets the same match sheets; what changes is which calls they lean on.
Apps and results sites
Results pages, club apps and score widgets that need every final score the moment the sheet is in.
latest_resultsfixturesget_matchModels and analysts
Ratings, totals and form, tested on 22 seasons of real results instead of a few months.
results_on_dayhead_to_headmatch_playersMedia and newsrooms
Match reports, previews and records written from the sheet, not retyped from a stream.
get_matchmatch_playerstop_scorersFantasy and games
Player points, keeper bonuses and season leaderboards from goals, seven-metres, saves and suspensions.
match_playerstop_scorersleague_tableEvery plan uses the same endpoints and the same fields. Paid plans reach further back and call more often. Cancel any time.
- 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
- 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
- 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
| What you get | Free key | Results | Archive |
|---|---|---|---|
| Calls a day | 50 | 5,000 | 25,000 |
| Calls a minute | 10 | 60 | 120 |
| History | Yesterday and today | This season and last | Every 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 |
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.
Each part checked every minute by our monitor, and how recently every country last took in a result.