List games

GET /v1/games

Free key and upMCP tool: find_games Paged, 50 a page

Games by date, date range, league, season or team: teams, score, how it ended, venue and attendance.

GEThttps://api.icehockeyapi.com/v1/games

Your key

dateYYYY-MM-DD fromYYYY-MM-DD toYYYY-MM-DD league_idid season_idid team_idid statusenum stageenum orderenum pageint per_pageint cursorstring

https://api.icehockeyapi.com/v1/games?date=2026-10-11&league_id=lg_6t11wec7&team_id=tm_kpzj338v&per_page=3

curl "https://api.icehockeyapi.com/v1/games?date=2026-10-11&league_id=lg_6t11wec7&team_id=tm_kpzj338v&per_page=3" \
  -H "X-API-Key: YOUR_KEY"

200 OKExample answer from the data, 12 Oct

{
    "data": [
        {
            "id": "gm_seyr9d88",
            "date": "2026-10-11",
            "start_time": "2026-10-11T22:00:00Z",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "season": {
                "id": "ss_0n4zhhna",
                "label": "2026-27"
            },
            "stage": "regular",
            "status": "final",
            "home_team": {
                "id": "tm_kpzj338v",
                "name": "New York Rangers",
                "short_name": "NYR",
                "country": "North America"
            },
            "away_team": {
                "id": "tm_ampzcavy",
                "name": "Vancouver Canucks",
                "short_name": "VAN",
                "country": "North America"
            },
            "home_goals": 6,
            "away_goals": 2,
            "ended_in": "regulation",
            "venue": {
                "id": "vn_aymp6wpr",
                "name": "Madison Square Garden",
                "city": null,
                "country": null
            },
            "attendance": null,
            "odds": [
                {
                    "market": "three_way",
                    "price": "average",
                    "format": "decimal",
                    "home": 1.6,
                    "draw": 4.68,
                    "away": 4.47
                }
            ]
        }
    ],
    "meta": {
        "count": 1,
        "next_cursor": null,
        "page": 1,
        "per_page": 3,
        "total": 1,
        "total_pages": 1,
        "next_page": null,
        "prev_page": null,
        "plan": "Complete"
    }
}

Parameters

Name	In	Type	What it does
`date`	query	date	One day, YYYY-MM-DD
`from`	query	date	First day of a range
`to`	query	date	Last day of a range
`league_id`	query	id	A league, from /v1/leagues.
`season_id`	query	id	A season, from /v1/leagues/{league_id}/seasons.
`team_id`	query	id	A team, from /v1/teams.
`status`	query	enum	Only games in this state. scheduledlivefinalpostponedcancelledawarded
`stage`	query	enum	Only this part of the season. regularplayoffsqualificationpreseasonfriendlycupother
`order`	query	enum	By date: asc (default) or desc ascdesc
`page`	query	int	The page, from 1.
`per_page`	query	int	Records a page, default 50, at most 200.
`cursor`	query	string	meta.next_cursor from the previous answer.

Returns

Field	Type
`id`	string
`date`	string
`start_time`	string
`league`	object
`league.id`	string
`league.name`	string
`season`	object
`season.id`	string
`season.label`	string
`stage`	string
`status`	string
`home_team`	object
`home_team.id`	string
`home_team.name`	string
`home_team.short_name`	string
`home_team.country`	string
`away_team`	object
`away_team.id`	string
`away_team.name`	string
`away_team.short_name`	string
`away_team.country`	string
`home_goals`	int
`away_goals`	int
`ended_in`	string
`venue`	object
`venue.id`	string
`venue.name`	string
`venue.city`	null
`venue.country`	null
`attendance`	null
`odds`	list

Errors

bad_requestunknown_parameterunauthorizedrate_limitedquota_exceededupgrade_required

PreviousHead to head NextUpcoming games