Documentation / Leagues

One league

GET /v1/leagues/{league_id}

Free key and up

One league, with its number of seasons and its latest season.

GEThttps://api.icehockeyapi.com/v1/leagues/{league_id}

Your key

Get a key

league_idrequired

https://api.icehockeyapi.com/v1/leagues/lg_6t11wec7

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

200 OKExample answer from the data, 12 Oct

{
    "data": {
        "id": "lg_6t11wec7",
        "name": "NHL",
        "country": "North America",
        "level": 1,
        "age_group": "senior",
        "gender": "men",
        "kind": "league",
        "seasons": 109,
        "games": 73156,
        "latest_season": {
            "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
        }
    },
    "meta": {
        "plan": "Complete"
    }
}

Parameters

Name	In	Type	What it does
`league_id` required	path	id	A league, from /v1/leagues.

Returns

Field	Type
`id`	string
`name`	string
`country`	string
`level`	int
`age_group`	string
`gender`	string
`kind`	string
`seasons`	int
`games`	int
`latest_season`	object
`latest_season.id`	string
`latest_season.league_id`	string
`latest_season.label`	string
`latest_season.start_year`	int
`latest_season.first_game_date`	string
`latest_season.last_game_date`	string
`latest_season.games`	int

Errors

bad_requestunknown_parameterunauthorizedrate_limitedquota_exceedednot_found

PreviousList leagues NextLeague seasons