Documentation / Teams

Team seasons

GET /v1/teams/{team_id}/seasons

Live and up

A team's regular season record, season by season, newest first, with points under each league's rule.

GEThttps://api.icehockeyapi.com/v1/teams/{team_id}/seasons

Your key

Get a key

team_idrequired

https://api.icehockeyapi.com/v1/teams/tm_kpzj338v/seasons

curl "https://api.icehockeyapi.com/v1/teams/tm_kpzj338v/seasons" \
  -H "X-API-Key: YOUR_KEY"

200 OKExample answer from the data, 12 Oct

{
    "data": [
        {
            "season_id": "ss_0n4zhhna",
            "label": "2026-27",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "games": 7,
            "wins": 5,
            "losses": 2,
            "ties": 0,
            "overtime_wins": 0,
            "overtime_losses": 0,
            "shootout_wins": 0,
            "shootout_losses": 0,
            "goals_for": 23,
            "goals_against": 13,
            "points": 10,
            "goal_difference": 10,
            "points_rule": "2-1-0"
        },
        {
            "season_id": "ss_22q138a1",
            "label": "2025-26",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "games": 82,
            "wins": 34,
            "losses": 48,
            "ties": 0,
            "overtime_wins": 6,
            "overtime_losses": 8,
            "shootout_wins": 3,
            "shootout_losses": 1,
            "goals_for": 238,
            "goals_against": 250,
            "points": 77,
            "goal_difference": -12,
            "points_rule": "2-1-0"
        },
        {
            "season_id": "ss_8rfxbg9h",
            "label": "2024-25",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "games": 82,
            "wins": 39,
            "losses": 43,
            "ties": 0,
            "overtime_wins": 3,
            "overtime_losses": 7,
            "shootout_wins": 1,
            "shootout_losses": 0,
            "goals_for": 256,
            "goals_against": 255,
            "points": 85,
            "goal_difference": 1,
            "points_rule": "2-1-0"
        }
    ],
    "meta": {
        "count": 100,
        "team_id": "tm_kpzj338v",
        "stage": "regular season",
        "plan": "Complete"
    }
}

Parameters

Name	In	Type	What it does
`team_id` required	path	id	A team, from /v1/teams.

Returns

Field	Type
`season_id`	string
`label`	string
`league`	object
`league.id`	string
`league.name`	string
`games`	int
`wins`	int
`losses`	int
`ties`	int
`overtime_wins`	int
`overtime_losses`	int
`shootout_wins`	int
`shootout_losses`	int
`goals_for`	int
`goals_against`	int
`points`	int
`goal_difference`	int
`points_rule`	string

Errors

bad_requestunknown_parameterunauthorizedrate_limitedquota_exceedednot_foundupgrade_required

PreviousTeam games NextRoster