// Teams of a competition
Teams of a competition
Free key and every planOlder dates: Results plan
Every team that played in a competition and season, with matches played.
GEThttps://api.handballapi.com/v1/competitions/{id}/teams
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) |
Returns5 fields
| field | type | what it holds |
|---|---|---|
team_id | string | Our id for the team (tm_). Permanent. |
name | string | The name as published. |
played | integer | Matches played. |
first_match | date | The first match held. |
last_match | date | The latest match held. |
Example answerGET /v1/competitions/cp_vdaq0xgv/teams?season=2026%2F27
20010 of 10 rows
{
"data": [
{
"team_id": "tm_m32520sc",
"name": "Allgemeiner Sportverein Hamm-Westfalen e.V.",
"played": 1,
"first_match": "2026-10-10",
"last_match": "2026-10-10"
},
{
"team_id": "tm_pd7mgxmj",
"name": "HSG HOHENLIMBURG II",
"played": 2,
"first_match": "2026-10-11",
"last_match": "2026-10-30"
},
{
"team_id": "tm_yxwkzkkn",
"name": "HSG Soest Damen",
"played": 1,
"first_match": "2026-10-10",
"last_match": "2026-10-10"
},
{
"team_id": "tm_52w5wbja",
"name": "HSG WETTER/GRUNDSCHÖTTEL",
"played": 1,
"first_match": "2026-10-10",
"last_match": "2026-10-10"
},
{
"team_id": "tm_vm7h9pbf",
"name": "LÜNER SV HANDBALL E.V. II",
"played": 1,
"first_match": "2026-10-11",
"last_match": "2026-10-11"
},
{
"team_id": "tm_vkcq92se",
"name": "SGH Unna Massen",
"played": 2,
"first_match": "2026-10-10",
"last_match": "2026-10-30"
},
{
"team_id": "tm_m6y101yy",
"name": "SOESTER TV VON 1862 E.V.",
"played": 1,
"first_match": "2026-10-11",
"last_match": "2026-10-11"
},
{
"team_id": "tm_csfmmw96",
"name": "TV ARNSBERG 1861 E.V.",
"played": 1,
"first_match": "2026-10-11",
"last_match": "2026-10-11"
},
{
"team_id": "tm_gpjswbwb",
"name": "TV WERNE 03 E.V.",
"played": 1,
"first_match": "2026-10-11",
"last_match": "2026-10-11"
},
{
"team_id": "tm_gggfcx9c",
"name": "VTV FREIER GRUND 2016 E.V.",
"played": 1,
"first_match": "2026-10-11",
"last_match": "2026-10-11"
}
],
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"compiled_at": "2026-10-31T03:40:01Z",
"count": 10,
"took_ms": 1
}
}