// Seasons of a competition
Seasons of a competition
Every season held for a competition, newest first: matches, teams, dates and how many matches have player lines.
GEThttps://api.handballapi.com/v1/competitions/{id}/seasons
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_...) |
Returns6 fields
| field | type | what it holds |
|---|---|---|
season | string | |
matches | integer | Matches with a line for the player. |
teams | integer | |
first_match | date | The first match held. |
last_match | date | The latest match held. |
matches_with_player_lines | integer |
Example answerGET /v1/competitions/cp_vdaq0xgv/seasons
2001 of 1 rows
{
"data": [
{
"season": "2026/27",
"matches": 6,
"teams": 6,
"first_match": "2026-10-10",
"last_match": "2026-10-30",
"matches_with_player_lines": 6
}
],
"meta": {
"competition_id": "cp_vdaq0xgv",
"count": 1,
"took_ms": 11
}
}