// One competition
One competition
Free key and every planOlder dates: Results plan
A competition: country, men or women, league or cup, seasons held, first and last match, and its latest season.
GEThttps://api.handballapi.com/v1/competitions/{id}
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.
Parameters1
| name | type | what it does | |
|---|---|---|---|
id | string | required | Competition id (cp_...) |
Returns10 fields
| field | type | what it holds |
|---|---|---|
id | string | Our id for the record. Permanent. |
name | string | The name as published. |
country | string | |
gender | string | men or women. |
kind | string | league, or cup for a knockout competition. |
matches | integer | Matches with a line for the player. |
seasons | integer | |
first_match | date | The first match held. |
last_match | date | The latest match held. |
latest_season | string |
Example answerGET /v1/competitions/cp_vdaq0xgv
200one record
{
"data": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"country": "de",
"gender": "women",
"kind": "league",
"matches": 6,
"seasons": 1,
"first_match": "2026-10-10",
"last_match": "2026-10-30",
"latest_season": "2026/27"
},
"meta": {
"took_ms": 13
}
}