API-Hockey

Follow ice hockey with API-Hockey: games and results with the score by period, goals and penalties, standings, team season statistics, head-to-head records and bookmakers' pre-match odds, for more than 250 leagues and cups, from the NHL and the AHL to the KHL, Sweden's SHL, Finland's Liiga and the world championships. Needs an API-SPORTS key; the free plan allows 100 requests a day.

Actions

Action	What it does
Find leagues and cups	Find hockey competitions by name, country, season or type, each with its ID, logo, country and every season on file with its dates.
Find teams	Find teams by name, by league and season, by country or by ID, each with its logo, country, colours, the year it was founded and its arena.
Get a game	Get one game by ID: its start time, round, status, the score and each period's goals, overtime and the shootout included.
Get account status	See the connected key's API-Hockey plan, when it renews, and how many of today's requests are used and left.
Get game events	Get a game's goals and penalties in the order they happened: the period and minute, the team, who scored or was penalised, the assists, and the kind of goal or the penalty.
Get pre-match odds	Get bookmakers' pre-match odds for a game, or for a league's games in a season, optionally from one bookmaker or for one bet type.
Get standings	Get a season's tables, such as the NHL's two conferences and four divisions: each team's place, games played, won and lost in regulation and in overtime, goals scored and conceded, points and form.
Get team statistics	Get a team's season in one competition: games played, won and lost at home, away and in all, overtime included, with their share of the games, and goals scored and conceded in total and per game.
List bet types	List the kinds of bet API-Hockey has odds for, such as Home/Away or Over/Under, with the IDs the odds filter takes.
List bookmakers	List the bookmakers API-Hockey has odds from, with the IDs the odds filter takes.
List countries	List the countries and regions that have hockey competitions in API-Hockey, each with its ID, code and flag.
List games	List games and results by day, by league and season, or by team, each with its start time, round, status, the score and each period's goals, overtime and the shootout included.
List head-to-head games	List the games two teams have played each other, in every season or only one league, season or day, with a count of each side's wins and goals across the finished ones.
List seasons	List the seasons API-Hockey has data for, oldest first, as the four-digit years the Season fields take.
List standings groups	List the groups a competition's season has, such as the NHL's conferences and divisions, by the names Get standings takes as its Group.
List standings stages	List the stages of a competition's season, such as the NHL's regular season and pre-season, which Get standings can narrow to.

Find leagues and cups

Find hockey competitions by name, country, season or type, each with its ID, logo, country and every season on file with its dates. With no filter it lists all of them.

Inputs

Leagueleague_idtext: Optional. Only this competition. Pick one from the list, or pass a league ID such as 57 for the NHL.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.
Countrycountrytext: Optional. Only this country, by name as the list gives it, such as USA, Canada or Sweden.
Seasonseasonnumber: Optional. Only this season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Typeleague_typetext: Optional. Only leagues, or only cups.One of: league, cup.

Outputs

countnumber: How many came back.
leagueslist: The competitions.

Example output

{
  "count": 1,
  "leagues": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "current_season": {
        "current": true,
        "end": "2027-04-11",
        "season": 2026,
        "start": "2026-09-19"
      },
      "id": 57,
      "logo": "https://media.api-sports.io/hockey/leagues/57.png",
      "name": "NHL",
      "seasons": [
        {
          "current": false,
          "end": "2025-06-18",
          "season": 2024,
          "start": "2024-09-21"
        },
        {
          "current": false,
          "end": "2026-06-15",
          "season": 2025,
          "start": "2025-09-20"
        },
        {
          "current": true,
          "end": "2027-04-11",
          "season": 2026,
          "start": "2026-09-19"
        }
      ],
      "type": "League"
    }
  ]
}

Find teams

Find teams by name, by league and season, by country or by ID, each with its logo, country, colours, the year it was founded and its arena.

Inputs

Team IDteam_idtext: Optional. Only this team, by ID, such as 704 for the Winnipeg Jets.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.
Leagueleague_idtext: Optional. Only this competition. Pick one from the list, or pass a league ID such as 57 for the NHL.
Seasonseasonnumber: Optional. Only this season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Countrycountrytext: Optional. Only this country, by name as the list gives it, such as USA, Canada or Sweden.

Outputs

countnumber: How many came back.
teamslist: The teams.

Example output

{
  "count": 1,
  "teams": [
    {
      "arena": {
        "capacity": null,
        "location": "Winnipeg, Manitoba",
        "name": "Winnipeg Arena"
      },
      "colors": [
        "Blue",
        "Red",
        "White"
      ],
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "founded": 1972,
      "id": 704,
      "logo": "https://media.api-sports.io/hockey/teams/704.png",
      "name": "Winnipeg Jets",
      "national": false
    }
  ]
}

Get a game

Get one game by ID: its start time, round, status, the score and each period's goals, overtime and the shootout included.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 370293. List games returns them.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as America/New_York or Europe/Stockholm. UTC when left empty.

Outputs

countryobject: A country, or a region such as World for international competitions.
datetext: When it starts, with the time zone's offset (ISO 8601).
has_eventstrue/false: True when Get game events has its goals and penalties.
idnumber: The game's ID.
leagueobject: The competition, and the season this is from.
periodsobject: The goals in each part of the game; null for a part not played.
scoresobject: Each side's goals, overtime included, and one more for the winner of a shootout. Null before the game starts.
statusobject: Where the game stands.
teamsobject: Both sides.
timetext: Its start time, HH:MM, in that time zone.
timertext: The game clock while it is being played, when the API has it.
timestampnumber: When it starts, as a Unix timestamp.
timezonetext: The time zone date and time are given in.
weektext: The playoff round, such as Quarter-finals or Final; null in the regular season.

Example output

{
  "country": {
    "code": "US",
    "flag": "https://media.api-sports.io/flags/us.svg",
    "id": 31,
    "name": "USA"
  },
  "date": "2024-09-22T22:00:00+00:00",
  "has_events": true,
  "id": 370293,
  "league": {
    "id": 57,
    "logo": "https://media.api-sports.io/hockey/leagues/57.png",
    "name": "NHL",
    "season": 2024,
    "type": "League"
  },
  "periods": {
    "first": {
      "away": 1,
      "home": 1
    },
    "overtime": {
      "away": 0,
      "home": 1
    },
    "penalties": {
      "away": null,
      "home": null
    },
    "second": {
      "away": 0,
      "home": 0
    },
    "third": {
      "away": 1,
      "home": 1
    }
  },
  "scores": {
    "away": 2,
    "home": 3
  },
  "status": {
    "long": "After Over Time",
    "short": "AOT"
  },
  "teams": {
    "away": {
      "id": 704,
      "logo": "https://media.api-sports.io/hockey/teams/704.png",
      "name": "Winnipeg Jets"
    },
    "home": {
      "id": 683,
      "logo": "https://media.api-sports.io/hockey/teams/683.png",
      "name": "Edmonton Oilers"
    }
  },
  "time": "22:00",
  "timer": null,
  "timestamp": 1727042400,
  "timezone": "UTC",
  "week": null
}

Get account status

See the connected key's API-Hockey plan, when it renews, and how many of today's requests are used and left. It is free: it never counts against the day.

Inputs

None.

Outputs

activetrue/false: True while the subscription is active.
daily_limitnumber: Requests allowed a day.
plantext: The plan, such as Free.
requests_remainingnumber: Requests left today; the day starts at midnight UTC.
requests_todaynumber: Requests used today.
subscription_endtext: When the plan renews or ends.

Example output

{
  "active": true,
  "daily_limit": 100,
  "plan": "Free",
  "requests_remaining": 88,
  "requests_today": 12,
  "subscription_end": "2027-10-01T00:00:00+00:00"
}

Get game events

Get a game's goals and penalties in the order they happened: the period and minute, the team, who scored or was penalised, the assists, and the kind of goal or the penalty.

Inputs

Game IDgame_idtextRequired: The game's ID, such as 370293. List games returns them, and says whether each game has events.

Outputs

countnumber: How many came back.
eventslist: Its goals and penalties, in order.
game_idnumber: The game asked about.

Example output

{
  "count": 3,
  "events": [
    {
      "assists": [
        "L. Stanley",
        "A. Jonsson Fjallby"
      ],
      "comment": null,
      "game_id": 370293,
      "minute": "00",
      "period": "P1",
      "players": [
        "D. Gustafsson"
      ],
      "team": {
        "id": 704,
        "logo": "https://media.api-sports.io/hockey/teams/704.png",
        "name": "Winnipeg Jets"
      },
      "type": "goal"
    },
    {
      "assists": [
        "C. Dineen",
        "C. Carrick"
      ],
      "comment": null,
      "game_id": 370293,
      "minute": "03",
      "period": "P1",
      "players": [
        "S. O'Reilly"
      ],
      "team": {
        "id": 683,
        "logo": "https://media.api-sports.io/hockey/teams/683.png",
        "name": "Edmonton Oilers"
      },
      "type": "goal"
    },
    {
      "assists": [],
      "comment": "Holding",
      "game_id": 370293,
      "minute": "03",
      "period": "P2",
      "players": [
        "D. Anhorn"
      ],
      "team": {
        "id": 704,
        "logo": "https://media.api-sports.io/hockey/teams/704.png",
        "name": "Winnipeg Jets"
      },
      "type": "penalty"
    }
  ],
  "game_id": 370293
}

Get pre-match odds

Get bookmakers' pre-match odds for a game, or for a league's games in a season, optionally from one bookmaker or for one bet type. Odds appear 1 to 7 days before a game, are updated once a day and are kept for 7 days after it.

Inputs

Game IDgame_idtext: Optional. Only this game's odds. Set this, or a league and a season.
Leagueleague_idtext: Optional. Only this competition. Pick one from the list, or pass a league ID such as 57 for the NHL.
Seasonseasonnumber: Optional. Only this season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Bookmakerbookmaker_idtext: Optional. Only this bookmaker's odds. Pick one from the list.
Bet typebet_idtext: Optional. Only this kind of bet, such as Home/Away. Pick one from the list.

Outputs

countnumber: How many came back.
oddslist: Each game's odds.

Example output

{
  "count": 1,
  "odds": [
    {
      "bookmakers": [
        {
          "bets": [
            {
              "id": 2,
              "name": "Home/Away",
              "values": [
                {
                  "odd": 2.25,
                  "value": "Home"
                },
                {
                  "odd": 1.57,
                  "value": "Away"
                }
              ]
            }
          ],
          "id": 3,
          "name": "bet365"
        }
      ],
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "game": {
        "country": {
          "code": "US",
          "flag": "https://media.api-sports.io/flags/us.svg",
          "id": 31,
          "name": "USA"
        },
        "date": "2026-10-02T00:00:00+00:00",
        "has_events": true,
        "id": 444609,
        "league": {
          "id": 57,
          "logo": "https://media.api-sports.io/hockey/leagues/57.png",
          "name": "NHL",
          "season": 2026,
          "type": "League"
        },
        "periods": {
          "first": {
            "away": 2,
            "home": 0
          },
          "overtime": {
            "away": null,
            "home": null
          },
          "penalties": {
            "away": null,
            "home": null
          },
          "second": {
            "away": 0,
            "home": 1
          },
          "third": {
            "away": 1,
            "home": 0
          }
        },
        "scores": {
          "away": 3,
          "home": 1
        },
        "status": {
          "long": "Finished",
          "short": "FT"
        },
        "teams": {
          "away": {
            "id": 687,
            "logo": "https://media.api-sports.io/hockey/teams/687.png",
            "name": "Minnesota Wild"
          },
          "home": {
            "id": 689,
            "logo": "https://media.api-sports.io/hockey/teams/689.png",
            "name": "Nashville Predators"
          }
        },
        "time": "00:00",
        "timer": null,
        "timestamp": 1790899200,
        "timezone": "UTC",
        "week": null
      },
      "league": {
        "id": 57,
        "logo": "https://media.api-sports.io/hockey/leagues/57.png",
        "name": "NHL",
        "season": 2026,
        "type": "League"
      }
    }
  ]
}

Get standings

Get a season's tables, such as the NHL's two conferences and four divisions: each team's place, games played, won and lost in regulation and in overtime, goals scored and conceded, points and form. Narrow to one team, stage or group.

Inputs

Leagueleague_idtextRequired: The competition, such as 57 for the NHL, 35 for the KHL or 47 for the SHL. Pick one from the list, or pass a league ID from an earlier step.
SeasonseasonnumberRequired: The season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Team IDteam_idtext: Optional. Only this team's line in each table it is in.
Stagestagetext: Optional. Only this stage, by name. List standings stages gives a season's stages.
Groupgrouptext: Optional. Only this group, by name, such as Central Division. List standings groups gives a season's groups.

Outputs

countnumber: How many came back.
standingslist: The tables, in the API's order.

Example output

{
  "count": 2,
  "standings": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "group": "Western Conference",
      "league": {
        "id": 57,
        "logo": "https://media.api-sports.io/hockey/leagues/57.png",
        "name": "NHL",
        "season": 2024,
        "type": "League"
      },
      "stage": "NHL - Regular Season",
      "table": [
        {
          "description": "Promotion - NHL (Play Offs: )",
          "form": "WLWWW",
          "games": {
            "losses": {
              "percentage": 0.268,
              "total": 22
            },
            "overtime_losses": {
              "percentage": 0.049,
              "total": 4
            },
            "overtime_wins": {
              "percentage": 0.159,
              "total": 13
            },
            "played": 82,
            "wins": {
              "percentage": 0.524,
              "total": 43
            }
          },
          "goals": {
            "against": 191,
            "for": 277
          },
          "points": 116,
          "position": 1,
          "team": {
            "id": 704,
            "logo": "https://media.api-sports.io/hockey/teams/704.png",
            "name": "Winnipeg Jets"
          }
        },
        {
          "description": "Promotion - NHL (Play Offs: )",
          "form": "WLWWL",
          "games": {
            "losses": {
              "percentage": 0.268,
              "total": 22
            },
            "overtime_losses": {
              "percentage": 0.122,
              "total": 10
            },
            "overtime_wins": {
              "percentage": 0.049,
              "total": 4
            },
            "played": 82,
            "wins": {
              "percentage": 0.561,
              "total": 46
            }
          },
          "goals": {
            "against": 219,
            "for": 275
          },
          "points": 110,
          "position": 2,
          "team": {
            "id": 702,
            "logo": "https://media.api-sports.io/hockey/teams/702.png",
            "name": "Vegas Golden Knights"
          }
        }
      ]
    },
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "group": "Central Division",
      "league": {
        "id": 57,
        "logo": "https://media.api-sports.io/hockey/leagues/57.png",
        "name": "NHL",
        "season": 2024,
        "type": "League"
      },
      "stage": "NHL - Regular Season",
      "table": [
        {
          "description": "Promotion - NHL (Play Offs: )",
          "form": "WLWWW",
          "games": {
            "losses": {
              "percentage": 0.268,
              "total": 22
            },
            "overtime_losses": {
              "percentage": 0.049,
              "total": 4
            },
            "overtime_wins": {
              "percentage": 0.159,
              "total": 13
            },
            "played": 82,
            "wins": {
              "percentage": 0.524,
              "total": 43
            }
          },
          "goals": {
            "against": 191,
            "for": 277
          },
          "points": 116,
          "position": 1,
          "team": {
            "id": 704,
            "logo": "https://media.api-sports.io/hockey/teams/704.png",
            "name": "Winnipeg Jets"
          }
        },
        {
          "description": "Promotion - NHL (Play Offs: )",
          "form": "LLLLL",
          "games": {
            "losses": {
              "percentage": 0.317,
              "total": 26
            },
            "overtime_losses": {
              "percentage": 0.073,
              "total": 6
            },
            "overtime_wins": {
              "percentage": 0.11,
              "total": 9
            },
            "played": 82,
            "wins": {
              "percentage": 0.5,
              "total": 41
            }
          },
          "goals": {
            "against": 224,
            "for": 277
          },
          "points": 106,
          "position": 2,
          "team": {
            "id": 681,
            "logo": "https://media.api-sports.io/hockey/teams/681.png",
            "name": "Dallas Stars"
          }
        }
      ]
    }
  ]
}

Get team statistics

Get a team's season in one competition: games played, won and lost at home, away and in all, overtime included, with their share of the games, and goals scored and conceded in total and per game.

Inputs

Leagueleague_idtextRequired: The competition, such as 57 for the NHL, 35 for the KHL or 47 for the SHL. Pick one from the list, or pass a league ID from an earlier step.
SeasonseasonnumberRequired: The season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Team IDteam_idtextRequired: The team's ID, such as 704 for the Winnipeg Jets. Find teams looks one up. A team's ID is the same in every competition.
Up to dateon_datedate: Optional. Count only games up to this day. The free plan takes only yesterday, today or tomorrow.

Outputs

countryobject: A country, or a region such as World for international competitions.
gamesobject: The team's record.
goalsobject: Goals scored and conceded.
leagueobject: The competition, and the season this is from.
teamobject: A team.

Example output

{
  "country": {
    "code": "US",
    "flag": "https://media.api-sports.io/flags/us.svg",
    "id": 31,
    "name": "USA"
  },
  "games": {
    "losses": {
      "all": {
        "percentage": 0.356,
        "total": 36
      },
      "away": {
        "percentage": 0.46,
        "total": 23
      },
      "home": {
        "percentage": 0.255,
        "total": 13
      }
    },
    "played": {
      "all": 101,
      "away": 50,
      "home": 51
    },
    "wins": {
      "all": {
        "percentage": 0.644,
        "total": 65
      },
      "away": {
        "percentage": 0.54,
        "total": 27
      },
      "home": {
        "percentage": 0.745,
        "total": 38
      }
    }
  },
  "goals": {
    "against": {
      "average": {
        "all": 2.5,
        "away": 3.0,
        "home": 2.0
      },
      "total": {
        "all": 252,
        "away": 150,
        "home": 102
      }
    },
    "for": {
      "average": {
        "all": 3.3,
        "away": 3.1,
        "home": 3.5
      },
      "total": {
        "all": 335,
        "away": 157,
        "home": 178
      }
    }
  },
  "league": {
    "id": 57,
    "logo": "https://media.api-sports.io/hockey/leagues/57.png",
    "name": "NHL",
    "season": 2024,
    "type": "League"
  },
  "team": {
    "id": 704,
    "logo": "https://media.api-sports.io/hockey/teams/704.png",
    "name": "Winnipeg Jets"
  }
}

List bet types

List the kinds of bet API-Hockey has odds for, such as Home/Away or Over/Under, with the IDs the odds filter takes.

Inputs

Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

betslist: The bet types.
countnumber: How many came back.

Example output

{
  "bets": [
    {
      "id": 1,
      "name": "3Way Result"
    },
    {
      "id": 2,
      "name": "Home/Away"
    }
  ],
  "count": 2
}

List bookmakers

List the bookmakers API-Hockey has odds from, with the IDs the odds filter takes. These IDs are API-Hockey's own: the same bookmaker can have another ID in another API-SPORTS API.

Inputs

Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

bookmakerslist: The bookmakers.
countnumber: How many came back.

Example output

{
  "bookmakers": [
    {
      "id": 1,
      "name": "bwin"
    },
    {
      "id": 3,
      "name": "bet365"
    }
  ],
  "count": 2
}

List countries

List the countries and regions that have hockey competitions in API-Hockey, each with its ID, code and flag. The names are what the Country filters take.

Inputs

Searchsearchtext: Optional. Only names containing this, at least 3 characters.
Country codecodetext: Optional. Only the country with this two-letter code, such as US, CA or SE.

Outputs

countnumber: How many came back.
countrieslist: The countries.

Example output

{
  "count": 2,
  "countries": [
    {
      "code": "US",
      "flag": "https://media.api-sports.io/flags/us.svg",
      "id": 31,
      "name": "USA"
    },
    {
      "code": null,
      "flag": null,
      "id": 34,
      "name": "World"
    }
  ]
}

List games

List games and results by day, by league and season, or by team, each with its start time, round, status, the score and each period's goals, overtime and the shootout included.

Inputs

Dateon_datedate: Optional. Only games on this day, in the time zone chosen below. The free plan takes only yesterday, today or tomorrow.
Leagueleague_idtext: Optional. Only this competition. Pick one from the list, or pass a league ID such as 57 for the NHL.
Seasonseasonnumber: Optional. Only this season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Team IDteam_idtext: Optional. Only this team, by ID, such as 704 for the Winnipeg Jets.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as America/New_York or Europe/Stockholm. UTC when left empty.

Outputs

countnumber: How many came back.
gameslist: The games, in the order given.

Example output

{
  "count": 1,
  "games": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "date": "2024-09-22T22:00:00+00:00",
      "has_events": true,
      "id": 370293,
      "league": {
        "id": 57,
        "logo": "https://media.api-sports.io/hockey/leagues/57.png",
        "name": "NHL",
        "season": 2024,
        "type": "League"
      },
      "periods": {
        "first": {
          "away": 1,
          "home": 1
        },
        "overtime": {
          "away": 0,
          "home": 1
        },
        "penalties": {
          "away": null,
          "home": null
        },
        "second": {
          "away": 0,
          "home": 0
        },
        "third": {
          "away": 1,
          "home": 1
        }
      },
      "scores": {
        "away": 2,
        "home": 3
      },
      "status": {
        "long": "After Over Time",
        "short": "AOT"
      },
      "teams": {
        "away": {
          "id": 704,
          "logo": "https://media.api-sports.io/hockey/teams/704.png",
          "name": "Winnipeg Jets"
        },
        "home": {
          "id": 683,
          "logo": "https://media.api-sports.io/hockey/teams/683.png",
          "name": "Edmonton Oilers"
        }
      },
      "time": "22:00",
      "timer": null,
      "timestamp": 1727042400,
      "timezone": "UTC",
      "week": null
    }
  ]
}

List head-to-head games

List the games two teams have played each other, in every season or only one league, season or day, with a count of each side's wins and goals across the finished ones.

Inputs

First team IDfirst_team_idtextRequired: One of the two teams, by ID, such as 704 for the Winnipeg Jets. The summary counts its wins first.
Second team IDsecond_team_idtextRequired: The other team, by ID, such as 681 for the Dallas Stars.
Leagueleague_idtext: Optional. Only this competition. Pick one from the list, or pass a league ID such as 57 for the NHL.
Seasonseasonnumber: Optional. Only this season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Dateon_datedate: Optional. Only games on this day, in the time zone chosen below. The free plan takes only yesterday, today or tomorrow.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as America/New_York or Europe/Stockholm. UTC when left empty.

Outputs

countnumber: How many came back.
gameslist: Their games, oldest first.
summaryobject: A count of the finished games among them, overtime and shootouts included.

Example output

{
  "count": 2,
  "games": [
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "date": "2024-11-09T20:00:00+00:00",
      "has_events": true,
      "id": 386460,
      "league": {
        "id": 57,
        "logo": "https://media.api-sports.io/hockey/leagues/57.png",
        "name": "NHL",
        "season": 2024,
        "type": "League"
      },
      "periods": {
        "first": {
          "away": 0,
          "home": 2
        },
        "overtime": {
          "away": null,
          "home": null
        },
        "penalties": {
          "away": null,
          "home": null
        },
        "second": {
          "away": 0,
          "home": 2
        },
        "third": {
          "away": 1,
          "home": 0
        }
      },
      "scores": {
        "away": 1,
        "home": 4
      },
      "status": {
        "long": "Finished",
        "short": "FT"
      },
      "teams": {
        "away": {
          "id": 681,
          "logo": "https://media.api-sports.io/hockey/teams/681.png",
          "name": "Dallas Stars"
        },
        "home": {
          "id": 704,
          "logo": "https://media.api-sports.io/hockey/teams/704.png",
          "name": "Winnipeg Jets"
        }
      },
      "time": "20:00",
      "timer": null,
      "timestamp": 1731182400,
      "timezone": "UTC",
      "week": null
    },
    {
      "country": {
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg",
        "id": 31,
        "name": "USA"
      },
      "date": "2024-12-01T21:30:00+00:00",
      "has_events": true,
      "id": 386621,
      "league": {
        "id": 57,
        "logo": "https://media.api-sports.io/hockey/leagues/57.png",
        "name": "NHL",
        "season": 2024,
        "type": "League"
      },
      "periods": {
        "first": {
          "away": 1,
          "home": 1
        },
        "overtime": {
          "away": null,
          "home": null
        },
        "penalties": {
          "away": null,
          "home": null
        },
        "second": {
          "away": 0,
          "home": 0
        },
        "third": {
          "away": 0,
          "home": 2
        }
      },
      "scores": {
        "away": 1,
        "home": 3
      },
      "status": {
        "long": "Finished",
        "short": "FT"
      },
      "teams": {
        "away": {
          "id": 704,
          "logo": "https://media.api-sports.io/hockey/teams/704.png",
          "name": "Winnipeg Jets"
        },
        "home": {
          "id": 681,
          "logo": "https://media.api-sports.io/hockey/teams/681.png",
          "name": "Dallas Stars"
        }
      },
      "time": "21:30",
      "timer": null,
      "timestamp": 1733088600,
      "timezone": "UTC",
      "week": null
    }
  ],
  "summary": {
    "draws": 0,
    "first_team_goals": 5,
    "first_team_wins": 1,
    "played": 2,
    "second_team_goals": 4,
    "second_team_wins": 1
  }
}

List seasons

List the seasons API-Hockey has data for, oldest first, as the four-digit years the Season fields take. A season played across two years is named by the year it starts in.

Inputs

None.

Outputs

countnumber: How many came back.
seasonslist: The seasons, oldest first.

Example output

{
  "count": 5,
  "seasons": [
    2022,
    2023,
    2024,
    2025,
    2026
  ]
}

List standings groups

List the groups a competition's season has, such as the NHL's conferences and divisions, by the names Get standings takes as its Group.

Inputs

Leagueleague_idtextRequired: The competition, such as 57 for the NHL, 35 for the KHL or 47 for the SHL. Pick one from the list, or pass a league ID from an earlier step.
SeasonseasonnumberRequired: The season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

countnumber: How many came back.
groupslist: The groups, by name.

Example output

{
  "count": 6,
  "groups": [
    "Western Conference",
    "Eastern Conference",
    "Atlantic Division",
    "Central Division",
    "Pacific Division",
    "Metropolitan Division"
  ]
}

List standings stages

List the stages of a competition's season, such as the NHL's regular season and pre-season, which Get standings can narrow to.

Inputs

Leagueleague_idtextRequired: The competition, such as 57 for the NHL, 35 for the KHL or 47 for the SHL. Pick one from the list, or pass a league ID from an earlier step.
SeasonseasonnumberRequired: The season, as the four-digit year it starts in, such as 2024 for 2024-25. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.

Outputs

countnumber: How many came back.
stageslist: The stages, by name.

Example output

{
  "count": 2,
  "stages": [
    "NHL - Regular Season",
    "NHL - Pre-season"
  ]
}

ActionsCopy Anchor Link

Find leagues and cupsCopy Anchor Link

Inputs

Outputs

Find teamsCopy Anchor Link

Inputs

Outputs

Get a gameCopy Anchor Link

Inputs

Outputs

Get account statusCopy Anchor Link

Inputs

Outputs

Get game eventsCopy Anchor Link

Inputs

Outputs

Get pre-match oddsCopy Anchor Link

Inputs

Outputs

Get standingsCopy Anchor Link

Inputs

Outputs

Get team statisticsCopy Anchor Link

Inputs

Outputs

List bet typesCopy Anchor Link

Inputs

Outputs

List bookmakersCopy Anchor Link

Inputs

Outputs

List countriesCopy Anchor Link

Inputs

Outputs

List gamesCopy Anchor Link

Inputs

Outputs

List head-to-head gamesCopy Anchor Link

Inputs

Outputs

List seasonsCopy Anchor Link

Inputs

Outputs

List standings groupsCopy Anchor Link

Inputs

Outputs

List standings stagesCopy Anchor Link

Inputs

Outputs

On this page

Actions

Find leagues and cups

Find teams

Get a game

Get account status

Get game events

Get pre-match odds

Get standings

Get team statistics

List bet types

List bookmakers

List countries

List games

List head-to-head games

List seasons

List standings groups

List standings stages