// Season figures of a team
Season figures of a team
Results plan and upMCP: team_stats
A team's season per competition: record, goals, home and away, goals a match, form and current run.
GEThttps://api.handballapi.com/v1/teams/{id}/stats
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 | Team id (tm_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
Returns14 fields
| field | type | what it holds |
|---|---|---|
competition | object | id (cp_), name, country and season, such as 2026/27. |
season | string | |
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. |
home | object | team_id (tm_), name, goals, and ht: goals at half-time, null where not published. |
away | object | The same for the away team. |
goals_for_per_match | number | |
goals_against_per_match | number | |
form | string | The last five results, newest first: W won, D drawn, L lost. |
streak | string | The current run, such as W3 for three wins. |
Example answerGET /v1/teams/tm_pd7mgxmj/stats
2001 of 1 rows
{
"data": [
{
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3"
},
"season": "2026/27",
"played": 2,
"won": 0,
"drawn": 0,
"lost": 2,
"goals_for": 45,
"goals_against": 60,
"home": {
"played": 1,
"won": 0,
"drawn": 0,
"lost": 1,
"goals_for": 20,
"goals_against": 29
},
"away": {
"played": 1,
"won": 0,
"drawn": 0,
"lost": 1,
"goals_for": 25,
"goals_against": 31
},
"goals_for_per_match": 22.5,
"goals_against_per_match": 30,
"form": "LL",
"streak": "L2"
}
],
"meta": {
"team_id": "tm_pd7mgxmj",
"season": "2026/27",
"count": 1,
"compiled_at": "2026-10-31T03:40:01Z",
"took_ms": 12
}
}