// One team

One team
Free key and every planOlder dates: Results plan

A team: country, men or women, matches held, first and last match and the competitions it played in.

GEThttps://api.handballapi.com/v1/teams/{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
idstringrequiredTeam id (tm_...)

Returns8 fields

fieldtypewhat it holds
team_idstringOur id for the team (tm_). Permanent.
namestringThe name as published.
countrystring
genderstringmen or women.
matchesintegerMatches with a line for the player.
first_matchdateThe first match held.
last_matchdateThe latest match held.
competitionsobject[]

Example answerGET /v1/teams/tm_pd7mgxmj

200one record
{
  "data": {
    "team_id": "tm_pd7mgxmj",
    "name": "HSG HOHENLIMBURG II",
    "country": "de",
    "gender": "women",
    "matches": 2,
    "first_match": "2026-10-11",
    "last_match": "2026-10-30",
    "competitions": [
      {
        "id": "cp_vdaq0xgv",
        "name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
        "matches": 2,
        "last_match": "2026-10-30"
      }
    ]
  },
  "meta": {
    "took_ms": 17
  }
}

Errorsthis endpoint can return