// Runs of a team

Runs of a team
Results plan and up

A team's current run and its longest winning, unbeaten and losing runs across every competition held.

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

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

Returns11 fields

fieldtypewhat it holds
team_idstringOur id for the team (tm_). Permanent.
namestringThe name as published.
playedintegerMatches played.
formstringThe last five results, newest first: W won, D drawn, L lost.
currentstring
unbeaten_runinteger
winless_runinteger
longest_winning_runinteger
longest_unbeaten_runinteger
longest_losing_runinteger
last_matchobjectThe latest match held.

Example answerGET /v1/teams/tm_pd7mgxmj/streaks

200one record
{
  "data": {
    "team_id": "tm_pd7mgxmj",
    "name": "HSG HOHENLIMBURG II",
    "played": 2,
    "form": "LL",
    "current": "L2",
    "unbeaten_run": 0,
    "winless_run": 2,
    "longest_winning_run": 0,
    "longest_unbeaten_run": 0,
    "longest_losing_run": 2,
    "last_match": {
      "id": "mt_r42fra39",
      "date_utc": "2026-10-30T20:30:00Z",
      "kickoff_local": "2026-10-30T21:30:00+01:00",
      "timezone": "Europe/Berlin",
      "status": "finished",
      "competition": {
        "id": "cp_vdaq0xgv",
        "name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
        "country": "de",
        "season": "2026/27"
      },
      "home": {
        "team_id": "tm_pd7mgxmj",
        "name": "HSG HOHENLIMBURG II",
        "goals": 20,
        "ht": null
      },
      "away": {
        "team_id": "tm_vkcq92se",
        "name": "SGH Unna Massen",
        "goals": 29,
        "ht": null
      }
    }
  },
  "meta": {
    "basis": "every competition held, oldest first; current is the run at the end, such as W3",
    "compiled_at": "2026-10-31T03:40:01Z",
    "took_ms": 1
  }
}

Errorsthis endpoint can return