// Season figures
Season figures
Results plan and upMCP: season_stats
A competition season in figures: goals a match, home and away goals, home win, draw and away win rates, average crowd.
GEThttps://api.handballapi.com/v1/competitions/{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 | Competition id (cp_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
Returns13 fields
| field | type | what it holds |
|---|---|---|
matches | integer | Matches with a line for the player. |
teams | integer | |
goals | integer | Goals scored. |
goals_per_match | number | Goals divided by matches. |
home_goals_per_match | number | |
away_goals_per_match | number | |
home_win_rate | number | Home wins divided by matches, 0 to 1. |
draw_rate | number | Draws divided by matches. |
away_win_rate | number | Away wins divided by matches. |
matches_with_half_time | integer | |
average_crowd | integer|null | |
first_match | date | The first match held. |
last_match | date | The latest match held. |
Example answerGET /v1/competitions/cp_vdaq0xgv/stats?season=2026%2F27
200one record
{
"data": {
"matches": 6,
"teams": 10,
"goals": 324,
"goals_per_match": 54,
"home_goals_per_match": 31.33,
"away_goals_per_match": 22.67,
"home_win_rate": 0.667,
"draw_rate": 0.167,
"away_win_rate": 0.167,
"matches_with_half_time": 0,
"average_crowd": null,
"first_match": "2026-10-10",
"last_match": "2026-10-30"
},
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"compiled_at": "2026-10-31T03:40:01Z",
"took_ms": 1
}
}