// Season records
Season records
Results plan and up
The biggest win, the highest and lowest scoring match and the largest crowd of a competition season.
GEThttps://api.handballapi.com/v1/competitions/{id}/records
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.
Parameters2
| name | type | what it does | |
|---|---|---|---|
id | string | required | Competition id (cp_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
Returns4 fields
| field | type | what it holds |
|---|---|---|
biggest_win | object | |
highest_scoring | object | |
lowest_scoring | object | |
largest_crowd | object|null |
Example answerGET /v1/competitions/cp_vdaq0xgv/records?season=2026%2F27
200one record
{
"data": {
"biggest_win": {
"id": "mt_vme952g2",
"date_utc": "2026-10-10T17:00:00Z",
"kickoff_local": "2026-10-10T19:00:00+02:00",
"timezone": "Europe/Berlin",
"status": "finished",
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"country": "de",
"season": "2026/27"
},
"home": {
"team_id": "tm_yxwkzkkn",
"name": "HSG Soest Damen",
"goals": 48,
"ht": null
},
"away": {
"team_id": "tm_52w5wbja",
"name": "HSG WETTER/GRUNDSCHÖTTEL",
"goals": 14,
"ht": null
}
},
"highest_scoring": {
"id": "mt_vme952g2",
"date_utc": "2026-10-10T17:00:00Z",
"kickoff_local": "2026-10-10T19:00:00+02:00",
"timezone": "Europe/Berlin",
"status": "finished",
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"country": "de",
"season": "2026/27"
},
"home": {
"team_id": "tm_yxwkzkkn",
"name": "HSG Soest Damen",
"goals": 48,
"ht": null
},
"away": {
"team_id": "tm_52w5wbja",
"name": "HSG WETTER/GRUNDSCHÖTTEL",
"goals": 14,
"ht": null
}
},
"lowest_scoring": {
"id": "mt_9x3r4c1y",
"date_utc": "2026-10-11T15:00:00Z",
"kickoff_local": "2026-10-11T17:00:00+02:00",
"timezone": "Europe/Berlin",
"status": "finished",
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"country": "de",
"season": "2026/27"
},
"home": {
"team_id": "tm_vm7h9pbf",
"name": "LÜNER SV HANDBALL E.V. II",
"goals": 29,
"ht": null
},
"away": {
"team_id": "tm_gpjswbwb",
"name": "TV WERNE 03 E.V.",
"goals": 16,
"ht": null
}
},
"largest_crowd": null
},
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"compiled_at": "2026-10-31T03:40:01Z",
"took_ms": 2
}
}