// One player

One player
Free key and every planOlder dates: Results plan

A player: position, nationality and birth date where published, latest team, matches, goals and dates.

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

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

Returns10 fields

fieldtypewhat it holds
player_idstringOur id for the player (pl_). Permanent.
namestringThe name as published.
positionstring|nullGK, LW, LB, CB, RB, RW or PV, where known.
nationalitystring|null
birth_datedate|null
teamobject|nullhome or away.
matchesintegerMatches with a line for the player.
goalsintegerGoals scored.
first_matchdateThe first match held.
last_matchdateThe latest match held.

Example answerGET /v1/players/pl_4stewt2m

200one record
{
  "data": {
    "player_id": "pl_4stewt2m",
    "name": "Jule Marie Pietzner",
    "position": null,
    "nationality": null,
    "birth_date": null,
    "team": {
      "team_id": "tm_pd7mgxmj",
      "name": "HSG HOHENLIMBURG II"
    },
    "matches": 2,
    "goals": 12,
    "first_match": "2026-10-11",
    "last_match": "2026-10-30"
  },
  "meta": {
    "compiled_at": "2026-10-31T03:40:01Z",
    "took_ms": 1
  }
}

Errorsthis endpoint can return