Documentation / Seasons

One season

GET /v1/seasons/{season_id}

Free key and up

One season: its league, label, dates and number of games.

GEThttps://api.icehockeyapi.com/v1/seasons/{season_id}

Your key

Get a key

season_idrequired

https://api.icehockeyapi.com/v1/seasons/ss_0n4zhhna

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

200 OKExample answer from the data, 12 Oct

{
    "data": {
        "id": "ss_0n4zhhna",
        "league_id": "lg_6t11wec7",
        "label": "2026-27",
        "start_year": 2026,
        "first_game_date": "2026-09-19",
        "last_game_date": "2026-10-20",
        "games": 216,
        "league_name": "NHL"
    },
    "meta": {
        "plan": "Complete"
    }
}

Parameters

Name	In	Type	What it does
`season_id` required	path	id	A season, from /v1/leagues/{league_id}/seasons.

Returns

Field	Type
`id`	string
`league_id`	string
`label`	string
`start_year`	int
`first_game_date`	string
`last_game_date`	string
`games`	int
`league_name`	string

Errors

bad_requestunknown_parameterunauthorizedrate_limitedquota_exceedednot_foundupgrade_required

PreviousLeague teams NextSeason games