// Countries
Countries
Free key and every plan
Every country and group held, with matches, results, first match, latest result and player lines.
GEThttps://api.handballapi.com/v1/countries
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.
Returns7 fields
| field | type | what it holds |
|---|---|---|
code | string | |
name | string | The name as published. |
matches | integer | Matches with a line for the player. |
results | integer | |
first_match | date | The first match held. |
last_result | date | |
player_lines | integer | How many player lines the match has: call its /players. |
Example answerGET /v1/countries
20015 of 15 rows
{
"data": [
{
"code": "gr",
"name": "Greece",
"matches": 22004,
"results": 20824,
"first_match": "2001-09-29",
"last_result": "2026-10-28",
"player_lines": 0
},
{
"code": "history",
"name": "History",
"matches": 20792,
"results": 20775,
"first_match": "1938-02-05",
"last_result": "2026-10-01",
"player_lines": 0
},
{
"code": "es",
"name": "Spain",
"matches": 23507,
"results": 20631,
"first_match": "2018-09-01",
"last_result": "2026-10-29",
"player_lines": 0
},
{
"code": "rs",
"name": "Serbia",
"matches": 18405,
"results": 16961,
"first_match": "2016-09-25",
"last_result": "2026-10-30",
"player_lines": 64
},
{
"code": "si",
"name": "Slovenia",
"matches": 15743,
"results": 15314,
"first_match": "2004-09-17",
"last_result": "2026-10-30",
"player_lines": 437153
},
{
"code": "se",
"name": "Sweden",
"matches": 4681,
"results": 4681,
"first_match": "2014-09-10",
"last_result": "2026-10-29",
"player_lines": 85774
},
{
"code": "ihf",
"name": "International",
"matches": 3198,
"results": 3084,
"first_match": "2019-01-10",
"last_result": "2026-10-10",
"player_lines": 79878
},
{
"code": "cz",
"name": "Czech Republic",
"matches": 3705,
"results": 2734,
"first_match": "2020-08-27",
"last_result": "2026-10-30",
"player_lines": 73490
},
{
"code": "hr",
"name": "Croatia",
"matches": 2854,
"results": 2300,
"first_match": "2019-09-13",
"last_result": "2026-10-30",
"player_lines": 68075
},
{
"code": "de",
"name": "Germany",
"matches": 25275,
"results": 2207,
"first_match": "2026-07-01",
"last_result": "2026-11-29",
"player_lines": 56348
},
{
"code": "sk",
"name": "Slovakia",
"matches": 1815,
"results": 1460,
"first_match": "2022-09-10",
"last_result": "2026-10-30",
"player_lines": 4216
},
{
"code": "br",
"name": "Brazil",
"matches": 1172,
"results": 1167,
"first_match": "1996-06-30",
"last_result": "2026-09-23",
"player_lines": 0
},
{
"code": "tr",
"name": "Turkey",
"matches": 1081,
"results": 964,
"first_match": "2025-08-22",
"last_result": "2026-10-25",
"player_lines": 14312
},
{
"code": "dk",
"name": "Denmark",
"matches": 678,
"results": 237,
"first_match": "2026-08-25",
"last_result": "2026-10-30",
"player_lines": 5673
},
{
"code": "ch",
"name": "Switzerland",
"matches": 62,
"results": 62,
"first_match": "1935-05-20",
"last_result": "1969-07-05",
"player_lines": 0
}
],
"meta": {
"count": 15,
"took_ms": 0
}
}