// Completeness
Completeness
Free key and every plan
Every competition season held, with how complete it is: results, half-time, venue, crowd, player lines, and how many of those lines add up to the score.
GEThttps://api.handballapi.com/v1/meta/completeness
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.
Parameters5
| name | type | what it does | |
|---|---|---|---|
country | string | optional | Country code dksesihrcztrgrbrdeskrseschihfhistory |
season | string | optional | Season, as YYYY/YYYY |
per_page | integer | optional | Rows per page, 1 to 200 (100) |
page | integer | optional | Page number, from 1. Wins over cursor |
cursor | string | optional | The next_cursor from the previous answer |
Returns15 fields
| field | type | what it holds |
|---|---|---|
competition_id | string | |
competition | string | id (cp_), name, country and season, such as 2026/27. |
country | string | |
season | string|null | |
discipline | string | indoor, beach or wheelchair handball. |
first_match | date|null | The first match held. |
last_match | date|null | The latest match held. |
matches | integer | Matches with a line for the player. |
results | integer | |
half_time_pct | number | |
venue_pct | number | |
attendance_pct | number | |
player_lines | string | How many player lines the match has: call its /players. |
with_player_lines_pct | number|null | |
lines_add_up_pct | number|null |
Example answerGET /v1/meta/completeness?country=si&per_page=3
2003 of 351 rows
{
"data": [
{
"competition_id": "cp_a0mh3kje",
"competition": "Liga NLB (1. SRL)",
"country": "si",
"season": "2026/2027",
"discipline": "indoor",
"first_match": "2026-09-02",
"last_match": "2027-03-20",
"matches": 132,
"results": 57,
"half_time_pct": 100,
"venue_pct": 100,
"attendance_pct": 100,
"player_lines": "published",
"with_player_lines_pct": 100,
"lines_add_up_pct": 93
},
{
"competition_id": "cp_ad51cy88",
"competition": "1. B SRL - moški",
"country": "si",
"season": "2026/2027",
"discipline": "indoor",
"first_match": "2026-09-04",
"last_match": "2027-03-20",
"matches": 132,
"results": 50,
"half_time_pct": 100,
"venue_pct": 100,
"attendance_pct": 100,
"player_lines": "published",
"with_player_lines_pct": 100,
"lines_add_up_pct": 76
},
{
"competition_id": "cp_q85aaxne",
"competition": "2. SRL - moški",
"country": "si",
"season": "2026/2027",
"discipline": "indoor",
"first_match": "2026-09-11",
"last_match": "2027-05-22",
"matches": 156,
"results": 41,
"half_time_pct": 100,
"venue_pct": 100,
"attendance_pct": 100,
"player_lines": "published",
"with_player_lines_pct": 100,
"lines_add_up_pct": 82.9
}
],
"meta": {
"count": 3,
"next_cursor": "cDI",
"page": 1,
"per_page": 3,
"total": 351,
"total_pages": 117,
"next_page": 2,
"prev_page": null,
"basis": "counted from the data, refreshed every 6 hours; results_only means the source publishes no player data at all",
"took_ms": 18
}
}