// Assists of a season

Assists of a season
Results plan and up

The leading assist makers of a competition and season, where the league publishes assists.

GEThttps://api.handballapi.com/v1/competitions/{id}/assists

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.

Parameters3

nametypewhat it does
idstringrequiredCompetition id (cp_...)
seasonstringoptionalSeason, such as 2025/26 (the latest with results)
limitintegeroptionalHow many rows, 1 to 200 (25)

Returns8 fields

fieldtypewhat it holds
rankintegerPlace in the list, from 1.
player_idstringOur id for the player (pl_). Permanent.
namestringThe name as published.
team_idstring|nullOur id for the team (tm_). Permanent.
teamstring|nullhome or away.
matchesintegerMatches with a line for the player.
assistsintegerAssists, where published.
goalsintegerGoals scored.

Example answerGET /v1/competitions/cp_vdaq0xgv/assists?season=2026%2F27

2000 of 0 rows
{
  "data": [],
  "meta": {
    "competition": {
      "id": "cp_vdaq0xgv",
      "name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
      "season": "2026/27"
    },
    "compiled_at": "2026-10-31T03:40:01Z",
    "count": 0,
    "note": "This competition's sources publish no assists.",
    "took_ms": 7
  }
}

Errorsthis endpoint can return