// Seasons of a player

Seasons of a player
Results plan and up

A player's seasons per competition and team, newest first, with the sums of the lines.

GEThttps://api.handballapi.com/v1/players/{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

nametypewhat it does
idstringrequiredPlayer id (pl_...)

Returns16 fields

fieldtypewhat it holds
seasonstring
competitionobjectid (cp_), name, country and season, such as 2026/27.
teamobject|nullhome or away.
matchesintegerMatches with a line for the player.
goalsintegerGoals scored.
shotsinteger|nullShots taken, where published.
seven_m_goalsinteger7m throws scored.
seven_m_shotsinteger|null7m throws taken.
assistsinteger|nullAssists, where published.
yellowintegerYellow cards.
two_mininteger2 minute suspensions.
redintegerRed cards.
savesinteger|nullGoalkeepers: saves.
shots_facedinteger|nullGoalkeepers: shots faced.
save_ratenumber|nullGoalkeepers: saves divided by shots faced, 0 to 1.
goals_per_matchnumberGoals divided by matches.

Example answerGET /v1/players/pl_4stewt2m/seasons

2001 of 1 rows
{
  "data": [
    {
      "season": "2026/27",
      "competition": {
        "id": "cp_vdaq0xgv",
        "name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3"
      },
      "team": {
        "team_id": "tm_pd7mgxmj",
        "name": "HSG HOHENLIMBURG II"
      },
      "matches": 2,
      "goals": 12,
      "shots": null,
      "seven_m_goals": 8,
      "seven_m_shots": 11,
      "assists": null,
      "yellow": 0,
      "two_min": 0,
      "red": 0,
      "saves": null,
      "shots_faced": null,
      "save_rate": null,
      "goals_per_match": 6
    }
  ],
  "meta": {
    "player_id": "pl_4stewt2m",
    "count": 1,
    "compiled_at": "2026-10-31T03:40:01Z",
    "took_ms": 13
  }
}

Errorsthis endpoint can return