// League table
League table
Results plan and upMCP: league_table
The table of a competition and season, computed from the results held: played, won, drawn, lost, goals and points.
GEThttps://api.handballapi.com/v1/competitions/{id}/table
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) |
Returns11 fields
| field | type | what it holds |
|---|---|---|
rank | integer | Place in the list, from 1. |
team_id | string | Our id for the team (tm_). Permanent. |
name | string | The name as published. |
played | integer | Matches played. |
won | integer | Matches won. |
drawn | integer | Matches drawn. |
lost | integer | Matches lost. |
goals_for | integer | Goals scored. |
goals_against | integer | Goals conceded. |
goal_diff | integer | Goals scored less goals conceded. |
points | integer | 2 for a win, 1 for a draw. |
Example answerGET /v1/competitions/cp_vdaq0xgv/table?season=2026%2F27
20010 of 10 rows
{
"data": [
{
"rank": 1,
"team_id": "tm_vkcq92se",
"name": "SGH Unna Massen",
"played": 2,
"won": 1,
"drawn": 1,
"lost": 0,
"goals_for": 54,
"goals_against": 45,
"goal_diff": 9,
"points": 3
},
{
"rank": 2,
"team_id": "tm_yxwkzkkn",
"name": "HSG Soest Damen",
"played": 1,
"won": 1,
"drawn": 0,
"lost": 0,
"goals_for": 48,
"goals_against": 14,
"goal_diff": 34,
"points": 2
},
{
"rank": 3,
"team_id": "tm_vm7h9pbf",
"name": "LÜNER SV HANDBALL E.V. II",
"played": 1,
"won": 1,
"drawn": 0,
"lost": 0,
"goals_for": 29,
"goals_against": 16,
"goal_diff": 13,
"points": 2
},
{
"rank": 4,
"team_id": "tm_csfmmw96",
"name": "TV ARNSBERG 1861 E.V.",
"played": 1,
"won": 1,
"drawn": 0,
"lost": 0,
"goals_for": 35,
"goals_against": 27,
"goal_diff": 8,
"points": 2
},
{
"rank": 5,
"team_id": "tm_m6y101yy",
"name": "SOESTER TV VON 1862 E.V.",
"played": 1,
"won": 1,
"drawn": 0,
"lost": 0,
"goals_for": 31,
"goals_against": 25,
"goal_diff": 6,
"points": 2
},
{
"rank": 6,
"team_id": "tm_m32520sc",
"name": "Allgemeiner Sportverein Hamm-Westfalen e.V.",
"played": 1,
"won": 0,
"drawn": 1,
"lost": 0,
"goals_for": 25,
"goals_against": 25,
"goal_diff": 0,
"points": 1
},
{
"rank": 7,
"team_id": "tm_gggfcx9c",
"name": "VTV FREIER GRUND 2016 E.V.",
"played": 1,
"won": 0,
"drawn": 0,
"lost": 1,
"goals_for": 27,
"goals_against": 35,
"goal_diff": -8,
"points": 0
},
{
"rank": 8,
"team_id": "tm_gpjswbwb",
"name": "TV WERNE 03 E.V.",
"played": 1,
"won": 0,
"drawn": 0,
"lost": 1,
"goals_for": 16,
"goals_against": 29,
"goal_diff": -13,
"points": 0
},
{
"rank": 9,
"team_id": "tm_pd7mgxmj",
"name": "HSG HOHENLIMBURG II",
"played": 2,
"won": 0,
"drawn": 0,
"lost": 2,
"goals_for": 45,
"goals_against": 60,
"goal_diff": -15,
"points": 0
},
{
"rank": 10,
"team_id": "tm_52w5wbja",
"name": "HSG WETTER/GRUNDSCHÖTTEL",
"played": 1,
"won": 0,
"drawn": 0,
"lost": 1,
"goals_for": 14,
"goals_against": 48,
"goal_diff": -34,
"points": 0
}
],
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"matches": 6,
"basis": "computed from the results held: 2 points a win, 1 a draw; ordered by points, goal difference, goals scored. Every stage of the competition in the season counts, and a league's own tie-break (head to head) may order level teams differently.",
"took_ms": 1
}
}