// Handball data coverage API
Coverage
Free key and every planMCP: coverage
What the archive holds, counted from the data: matches, results and player lines by country, and what is never collected.
GEThttps://api.handballapi.com/v1/meta/coverage
Try itruns against the live API with your key
keyGet a free key
Kept in this browser and filled in on every docs page. A key made in your account appears here by itself.
Returns5 fields
| field | type | what it holds |
|---|---|---|
in_play | boolean | Always false: nothing is served during play. |
collected | string | When results are collected. |
not_collected | string[] | Competitions never collected, and why. |
countries | object[] | Matches, results, first and latest dates and player lines, by country. |
totals | object | The same counts for everything. |
Example answerGET /v1/meta/coverage
200one record
{
"data": {
"in_play": false,
"collected": "after full time",
"not_collected": [
"Handball-Bundesliga: Sportradar is its official data partner (HBL, 2. HBL, DHB Cup, Super Cup) through 2026/27",
"EHF competitions: Sportradar holds data collection and distribution rights (10-year agreement from 2020)",
"Superliga (Poland, men and women): STATSCORE is its official statistics provider (since 2017/18, extended through 2026/27)",
"Austrian Handball Leagues (HLA Meisterliga, HLA Challenge): Sportradar holds exclusive data rights from 2018 for ten years",
"Liga ASOBAL (Spain, men's top league, its cup and super cup): Sportradar manages its official competition data from August 2026",
"Czech men's Extraliga and the Czech cups (men and women): FeedConstruct holds exclusive data coverage rights for the Extraliga, and data and video rights for both cups from the quarter-finals (announced 25 Sep 2023)"
],
"countries": [
{
"country": "gr",
"name": "Greece",
"matches": 22004,
"results": 20824,
"first": "2001-09-29",
"last_result": "2026-10-28",
"player_lines": 0
},
{
"country": "history",
"name": "History",
"matches": 20792,
"results": 20775,
"first": "1938-02-05",
"last_result": "2026-10-01",
"player_lines": 0
},
{
"country": "es",
"name": "Spain",
"matches": 23507,
"results": 20631,
"first": "2018-09-01",
"last_result": "2026-10-29",
"player_lines": 0
},
{
"country": "rs",
"name": "Serbia",
"matches": 18405,
"results": 16961,
"first": "2016-09-25",
"last_result": "2026-10-30",
"player_lines": 64
},
{
"country": "si",
"name": "Slovenia",
"matches": 15743,
"results": 15314,
"first": "2004-09-17",
"last_result": "2026-10-30",
"player_lines": 437153
},
{
"country": "se",
"name": "Sweden",
"matches": 4681,
"results": 4681,
"first": "2014-09-10",
"last_result": "2026-10-29",
"player_lines": 85774
},
{
"country": "ihf",
"name": "International",
"matches": 3198,
"results": 3084,
"first": "2019-01-10",
"last_result": "2026-10-10",
"player_lines": 79878
},
{
"country": "cz",
"name": "Czech Republic",
"matches": 3705,
"results": 2734,
"first": "2020-08-27",
"last_result": "2026-10-30",
"player_lines": 73490
},
{
"country": "hr",
"name": "Croatia",
"matches": 2854,
"results": 2300,
"first": "2019-09-13",
"last_result": "2026-10-30",
"player_lines": 68075
},
{
"country": "de",
"name": "Germany",
"matches": 25275,
"results": 2207,
"first": "2026-07-01",
"last_result": "2026-11-29",
"player_lines": 56348
},
{
"country": "sk",
"name": "Slovakia",
"matches": 1815,
"results": 1460,
"first": "2022-09-10",
"last_result": "2026-10-30",
"player_lines": 4216
},
{
"country": "br",
"name": "Brazil",
"matches": 1172,
"results": 1167,
"first": "1996-06-30",
"last_result": "2026-09-23",
"player_lines": 0
},
{
"country": "tr",
"name": "Turkey",
"matches": 1081,
"results": 964,
"first": "2025-08-22",
"last_result": "2026-10-25",
"player_lines": 14312
},
{
"country": "dk",
"name": "Denmark",
"matches": 678,
"results": 237,
"first": "2026-08-25",
"last_result": "2026-10-30",
"player_lines": 5673
},
{
"country": "ch",
"name": "Switzerland",
"matches": 62,
"results": 62,
"first": "1935-05-20",
"last_result": "1969-07-05",
"player_lines": 0
}
],
"totals": {
"matches": 144972,
"results": 113401,
"player_lines": 824983
}
},
"meta": {
"cached": false,
"took_ms": 1170
}
}