Documentation / Teams

Team games

GET /v1/teams/{team_id}/games

Free key and upPaged, 50 a page

A team's results and fixtures by date, optionally for one season or a date range.

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

Your key

Get a key

team_idrequired season_idid fromYYYY-MM-DD toYYYY-MM-DD stageenum statusenum orderenum pageint per_pageint cursorstring

https://api.icehockeyapi.com/v1/teams/tm_kpzj338v/games?season_id=ss_0n4zhhna&per_page=3

curl "https://api.icehockeyapi.com/v1/teams/tm_kpzj338v/games?season_id=ss_0n4zhhna&per_page=3" \
  -H "X-API-Key: YOUR_KEY"

200 OKExample answer from the data, 12 Oct

{
    "data": [
        {
            "id": "gm_kx9rchmc",
            "date": "2026-09-21",
            "start_time": "2026-09-21T23:00:00Z",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "season": {
                "id": "ss_0n4zhhna",
                "label": "2026-27"
            },
            "stage": "preseason",
            "status": "final",
            "home_team": {
                "id": "tm_vxt1q0ha",
                "name": "New Jersey Devils",
                "short_name": "NJD",
                "country": "North America"
            },
            "away_team": {
                "id": "tm_kpzj338v",
                "name": "New York Rangers",
                "short_name": "NYR",
                "country": "North America"
            },
            "home_goals": 3,
            "away_goals": 2,
            "ended_in": "regulation",
            "venue": {
                "id": "vn_98eh74ka",
                "name": "Prudential Center",
                "city": null,
                "country": null
            },
            "attendance": 11156,
            "odds": []
        },
        {
            "id": "gm_vcs066ba",
            "date": "2026-09-22",
            "start_time": "2026-09-22T23:00:00Z",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "season": {
                "id": "ss_0n4zhhna",
                "label": "2026-27"
            },
            "stage": "preseason",
            "status": "final",
            "home_team": {
                "id": "tm_kpzj338v",
                "name": "New York Rangers",
                "short_name": "NYR",
                "country": "North America"
            },
            "away_team": {
                "id": "tm_zy5w8596",
                "name": "New York Islanders",
                "short_name": "NYI",
                "country": "North America"
            },
            "home_goals": 3,
            "away_goals": 4,
            "ended_in": "regulation",
            "venue": {
                "id": "vn_aymp6wpr",
                "name": "Madison Square Garden",
                "city": null,
                "country": null
            },
            "attendance": 16603,
            "odds": []
        },
        {
            "id": "gm_v7m24nbp",
            "date": "2026-09-24",
            "start_time": "2026-09-24T23:00:00Z",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "season": {
                "id": "ss_0n4zhhna",
                "label": "2026-27"
            },
            "stage": "preseason",
            "status": "final",
            "home_team": {
                "id": "tm_kpzj338v",
                "name": "New York Rangers",
                "short_name": "NYR",
                "country": "North America"
            },
            "away_team": {
                "id": "tm_vxt1q0ha",
                "name": "New Jersey Devils",
                "short_name": "NJD",
                "country": "North America"
            },
            "home_goals": 4,
            "away_goals": 3,
            "ended_in": "shootout",
            "venue": {
                "id": "vn_aymp6wpr",
                "name": "Madison Square Garden",
                "city": null,
                "country": null
            },
            "attendance": 16078,
            "odds": []
        }
    ],
    "meta": {
        "count": 3,
        "next_cursor": "eyJvIjozLCJuIjozfQ",
        "page": 1,
        "per_page": 3,
        "total": 12,
        "total_pages": 4,
        "next_page": 2,
        "prev_page": null,
        "plan": "Complete"
    }
}

Parameters

Name	In	Type	What it does
`team_id` required	path	id	A team, from /v1/teams.
`season_id`	query	id	A season, from /v1/leagues/{league_id}/seasons.
`from`	query	date	First day of a range
`to`	query	date	Last day of a range
`stage`	query	enum	Only this part of the season. regularplayoffsqualificationpreseasonfriendlycupother
`status`	query	enum	Only games in this state. scheduledlivefinalpostponedcancelledawarded
`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`	int
`odds`	list

Errors

bad_requestunknown_parameterunauthorizedrate_limitedquota_exceedednot_foundupgrade_required

PreviousOne team NextTeam seasons