// Squad of a season

Squad of a season
Results plan and upMCP: team_squad

Every player with a line for the team in a season, with matches and goals.

GEThttps://api.handballapi.com/v1/teams/{id}/squad

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

nametypewhat it does
idstringrequiredTeam id (tm_...)
seasonstringoptionalSeason, such as 2025/26 (the latest with results)

Returns5 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.
matchesintegerMatches with a line for the player.
goalsintegerGoals scored.

Example answerGET /v1/teams/tm_pd7mgxmj/squad

20018 of 18 rows
{
  "data": [
    {
      "player_id": "pl_4stewt2m",
      "name": "Jule Marie Pietzner",
      "position": null,
      "matches": 2,
      "goals": 12
    },
    {
      "player_id": "pl_4da324ga",
      "name": "Johanna Teresa Lohre",
      "position": null,
      "matches": 2,
      "goals": 10
    },
    {
      "player_id": "pl_2vsbp0hb",
      "name": "Lenja Stranegger",
      "position": null,
      "matches": 2,
      "goals": 6
    },
    {
      "player_id": "pl_wx9rj2p5",
      "name": "Sophia Geuss",
      "position": null,
      "matches": 2,
      "goals": 6
    },
    {
      "player_id": "pl_qma43eqc",
      "name": "Nele Marie Bleicher",
      "position": null,
      "matches": 2,
      "goals": 5
    },
    {
      "player_id": "pl_xqxwt7m9",
      "name": "Frida Dewenter",
      "position": null,
      "matches": 2,
      "goals": 2
    },
    {
      "player_id": "pl_4z1bgb2t",
      "name": "Sara Luettringhaus",
      "position": null,
      "matches": 2,
      "goals": 2
    },
    {
      "player_id": "pl_aeqr40cr",
      "name": "Sophie Kahlert",
      "position": null,
      "matches": 2,
      "goals": 0
    },
    {
      "player_id": "pl_1d80vh19",
      "name": "Insa Schroth",
      "position": null,
      "matches": 2,
      "goals": 0
    },
    {
      "player_id": "pl_bbdkc40e",
      "name": "Dana Loreen Konopka",
      "position": null,
      "matches": 2,
      "goals": 0
    },
    {
      "player_id": "pl_gxp3mpnm",
      "name": "Liv Malin Segrewe",
      "position": null,
      "matches": 2,
      "goals": 0
    },
    {
      "player_id": "pl_c4xvpdzv",
      "name": "Joyce Handwerker",
      "position": null,
      "matches": 1,
      "goals": 1
    },
    {
      "player_id": "pl_2p8qcr8t",
      "name": "Selina Lutz",
      "position": null,
      "matches": 1,
      "goals": 1
    },
    {
      "player_id": "pl_94f57g05",
      "name": "Jaqueline Tesdorff",
      "position": null,
      "matches": 1,
      "goals": 0
    },
    {
      "player_id": "pl_7739q6pv",
      "name": "Celina Mehlmann",
      "position": null,
      "matches": 1,
      "goals": 0
    },
    {
      "player_id": "pl_59nvycrk",
      "name": "Ann Christin Kriwett",
      "position": null,
      "matches": 1,
      "goals": 0
    },
    {
      "player_id": "pl_tvm3hk6z",
      "name": "Lucie Höllein",
      "position": null,
      "matches": 1,
      "goals": 0
    },
    {
      "player_id": "pl_s8ydn2hb",
      "name": "Kristin Wortmann",
      "position": null,
      "matches": 1,
      "goals": 0
    }
  ],
  "meta": {
    "team_id": "tm_pd7mgxmj",
    "season": "2026/27",
    "count": 18,
    "basis": "every player with a line for the team in the season",
    "compiled_at": "2026-10-31T03:40:01Z",
    "took_ms": 1
  }
}

Errorsthis endpoint can return