Documentation / Games

Results by date

GET /v1/results

Free key and upPaged, 50 a page

Finished games for one day or a date range, optionally for one league. Give date, or from (and to).

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

Your key

Get a key

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

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

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

200 OKExample answer from the data, 12 Oct

{
    "data": [
        {
            "id": "gm_sxe029v9",
            "date": "2026-10-11",
            "start_time": "2026-10-11T21:00:00Z",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "season": {
                "id": "ss_0n4zhhna",
                "label": "2026-27"
            },
            "stage": "regular",
            "status": "final",
            "home_team": {
                "id": "tm_rt3xcyx4",
                "name": "Washington Capitals",
                "short_name": "WSH",
                "country": "North America"
            },
            "away_team": {
                "id": "tm_dphk633j",
                "name": "Seattle Kraken",
                "short_name": "SEA",
                "country": "North America"
            },
            "home_goals": 3,
            "away_goals": 5,
            "ended_in": "regulation",
            "venue": {
                "id": "vn_kwrwver8",
                "name": "Capital One Arena",
                "city": null,
                "country": null
            },
            "attendance": null,
            "odds": [
                {
                    "market": "three_way",
                    "price": "average",
                    "format": "decimal",
                    "home": 1.79,
                    "draw": 4.45,
                    "away": 3.58
                }
            ]
        },
        {
            "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
                }
            ]
        },
        {
            "id": "gm_8b73gzzc",
            "date": "2026-10-11",
            "start_time": "2026-10-11T23:00:00Z",
            "league": {
                "id": "lg_6t11wec7",
                "name": "NHL"
            },
            "season": {
                "id": "ss_0n4zhhna",
                "label": "2026-27"
            },
            "stage": "regular",
            "status": "final",
            "home_team": {
                "id": "tm_qfd8n54x",
                "name": "Philadelphia Flyers",
                "short_name": "PHI",
                "country": "North America"
            },
            "away_team": {
                "id": "tm_24hh7x72",
                "name": "Carolina Hurricanes",
                "short_name": "CAR",
                "country": "North America"
            },
            "home_goals": 1,
            "away_goals": 4,
            "ended_in": "regulation",
            "venue": {
                "id": "vn_rv68rp77",
                "name": "Xfinity Mobile Arena",
                "city": null,
                "country": null
            },
            "attendance": null,
            "odds": []
        }
    ],
    "meta": {
        "count": 3,
        "next_cursor": null,
        "page": 1,
        "per_page": 3,
        "total": 3,
        "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.
`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_exceeded

PreviousYesterday's results NextPeriods