// Goalkeepers of a season
Goalkeepers of a season
Results plan and upMCP: top_goalkeepers
The best save rates of a competition and season, among goalkeepers who faced at least min_shots shots.
GEThttps://api.handballapi.com/v1/competitions/{id}/goalkeepers
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.
Parameters4
| name | type | what it does | |
|---|---|---|---|
id | string | required | Competition id (cp_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
limit | integer | optional | How many rows, 1 to 200 (25) |
min_shots | integer | optional | Shots faced at least (30) |
Returns9 fields
| field | type | what it holds |
|---|---|---|
rank | integer | Place in the list, from 1. |
player_id | string | Our id for the player (pl_). Permanent. |
name | string | The name as published. |
team_id | string|null | Our id for the team (tm_). Permanent. |
team | string|null | home or away. |
gk_matches | integer | Matches in goal (with shots faced). |
saves | integer | Goalkeepers: saves. |
shots_faced | integer | Goalkeepers: shots faced. |
save_rate | number | Goalkeepers: saves divided by shots faced, 0 to 1. |
Example answerGET /v1/competitions/cp_vdaq0xgv/goalkeepers?season=2026%2F27
2000 of 0 rows
{
"data": [],
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"compiled_at": "2026-10-31T03:40:01Z",
"min_shots": 30,
"count": 0,
"took_ms": 7
}
}