// Career of a player

Career of a player
Results plan and upMCP: player_career

A player's career totals, and per competition, across everything held.

GEThttps://api.handballapi.com/v1/players/{id}/career

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_...)

Returns4 fields

fieldtypewhat it holds
player_idstringOur id for the player (pl_). Permanent.
namestringThe name as published.
totalsobjectThe same counts for everything.
competitionsobject[]

Example answerGET /v1/players/pl_4stewt2m/career

200one record
{
  "data": {
    "player_id": "pl_4stewt2m",
    "name": "Jule Marie Pietzner",
    "totals": {
      "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
    },
    "competitions": [
      {
        "competition": {
          "id": "cp_vdaq0xgv",
          "name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3"
        },
        "seasons": 1,
        "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": {
    "compiled_at": "2026-10-31T03:40:01Z",
    "took_ms": 15
  }
}

Errorsthis endpoint can return