# Ice Hockey API

> Ice hockey data over a REST API and an MCP server: 48 endpoints covering 1,275 leagues and competitions worldwide, results back to , box scores, standings, players and odds.
> Factual data only: no predictions, ratings or tips.

## Complete reference

- [Full manual, one file](https://icehockeyapi.com/documentation/manual.md): every endpoint, parameter, sample response and guide in a single markdown document.
- [OpenAPI](https://icehockeyapi.com/openapi.json): machine-readable API description.
- [MCP server](https://icehockeyapi.com/mcp): Model Context Protocol endpoint.

## Agent skill

- [Ice Hockey API agent skill](https://icehockeyapi.com/.well-known/agent-skills/icehockeyapi/SKILL.md): how agents use Ice Hockey API. Index: https://icehockeyapi.com/.well-known/agent-skills/index.json

## Guides

- [Quick start](https://icehockeyapi.com/documentation/quick-start): A key, the first call and the answer, in a minute.
- [Authentication](https://icehockeyapi.com/documentation/authentication): Your key, the two ways to send it, and making a new one.
- [Plans and limits](https://icehockeyapi.com/documentation/plans-and-limits): What each plan reads, its calls and its rate.
- [How fresh the data is](https://icehockeyapi.com/documentation/how-fresh): When results, detail and odds arrive, the same on every plan.
- [Pagination](https://icehockeyapi.com/documentation/pagination): Pages and cursors for every list.
- [Errors](https://icehockeyapi.com/documentation/errors): Every error code, what it means and what to do.
- [Ids and names](https://icehockeyapi.com/documentation/ids-and-names): How ids work, how records link, and dates.
- [Games and results](https://icehockeyapi.com/documentation/games-and-results): Finding games, following a night, reading results.
- [Inside a game](https://icehockeyapi.com/documentation/inside-a-game): Periods, goals, penalties, lineups, lines, events, officials and coaches.
- [Odds](https://icehockeyapi.com/documentation/odds): Markets, prices and formats.
- [Players and careers](https://icehockeyapi.com/documentation/players-and-careers): Finding players, careers, game logs, awards and drafts.
- [MCP](https://icehockeyapi.com/documentation/mcp): The API as tools for Claude, ChatGPT, Cursor and other assistants.
- [MCP tools](https://icehockeyapi.com/documentation/mcp-tools): Every tool the MCP server offers, from the same registry as the API.
- [Agent skill](https://icehockeyapi.com/documentation/agent-skill): One file that teaches an agent to use the API.
- [Changelog](https://icehockeyapi.com/documentation/changelog): What changed, newest first.

## Endpoints

- [GET /v1/usage](https://icehockeyapi.com/documentation/usage): Your usage
- [GET /v1/coverage](https://icehockeyapi.com/documentation/coverage): Coverage
- [GET /v1/countries](https://icehockeyapi.com/documentation/countries): Countries
- [GET /v1/leagues](https://icehockeyapi.com/documentation/leagues): List leagues
- [GET /v1/leagues/{league_id}](https://icehockeyapi.com/documentation/league): One league
- [GET /v1/leagues/{league_id}/seasons](https://icehockeyapi.com/documentation/league-seasons): League seasons
- [GET /v1/leagues/{league_id}/teams](https://icehockeyapi.com/documentation/league-teams): League teams
- [GET /v1/seasons/{season_id}](https://icehockeyapi.com/documentation/season): One season
- [GET /v1/seasons/{season_id}/games](https://icehockeyapi.com/documentation/season-games): Season games
- [GET /v1/seasons/{season_id}/standings](https://icehockeyapi.com/documentation/season-standings): Standings
- [GET /v1/seasons/{season_id}/teams](https://icehockeyapi.com/documentation/season-teams): Season teams
- [GET /v1/seasons/{season_id}/playoffs](https://icehockeyapi.com/documentation/season-playoffs): Playoffs
- [GET /v1/seasons/{season_id}/leaders](https://icehockeyapi.com/documentation/season-leaders): Leaders
- [GET /v1/seasons/{season_id}/summary](https://icehockeyapi.com/documentation/season-summary): Season summary
- [GET /v1/teams](https://icehockeyapi.com/documentation/teams): List teams
- [GET /v1/teams/{team_id}](https://icehockeyapi.com/documentation/team): One team
- [GET /v1/teams/{team_id}/games](https://icehockeyapi.com/documentation/team-games): Team games
- [GET /v1/teams/{team_id}/seasons](https://icehockeyapi.com/documentation/team-seasons): Team seasons
- [GET /v1/teams/{team_id}/roster](https://icehockeyapi.com/documentation/team-roster): Roster
- [GET /v1/teams/{team_id}/stats](https://icehockeyapi.com/documentation/team-stats): Team stats
- [GET /v1/teams/{team_id}/head-to-head/{other_id}](https://icehockeyapi.com/documentation/head-to-head): Head to head
- [GET /v1/games](https://icehockeyapi.com/documentation/games): List games
- [GET /v1/games/upcoming](https://icehockeyapi.com/documentation/games-upcoming): Upcoming games
- [GET /v1/games/{game_id}](https://icehockeyapi.com/documentation/game): One game
- [GET /v1/results/yesterday](https://icehockeyapi.com/documentation/results-yesterday): Yesterday's results
- [GET /v1/results](https://icehockeyapi.com/documentation/results): Results by date
- [GET /v1/games/{game_id}/periods](https://icehockeyapi.com/documentation/game-periods): Periods
- [GET /v1/games/{game_id}/goals](https://icehockeyapi.com/documentation/game-goals): Goals
- [GET /v1/games/{game_id}/penalties](https://icehockeyapi.com/documentation/game-penalties): Penalties
- [GET /v1/games/{game_id}/lineups](https://icehockeyapi.com/documentation/game-lineups): Lineups
- [GET /v1/games/{game_id}/skaters](https://icehockeyapi.com/documentation/game-skaters): Skater stats
- [GET /v1/games/{game_id}/goalies](https://icehockeyapi.com/documentation/game-goalies): Goalie stats
- [GET /v1/games/{game_id}/team-stats](https://icehockeyapi.com/documentation/game-team-stats): Game team stats
- [GET /v1/games/{game_id}/events](https://icehockeyapi.com/documentation/game-events): Play by play
- [GET /v1/games/{game_id}/officials](https://icehockeyapi.com/documentation/game-officials): Officials
- [GET /v1/games/{game_id}/coaches](https://icehockeyapi.com/documentation/game-coaches): Coaches
- [GET /v1/games/{game_id}/stars](https://icehockeyapi.com/documentation/game-stars): Three stars
- [GET /v1/games/{game_id}/odds](https://icehockeyapi.com/documentation/game-odds): Game odds
- [GET /v1/odds](https://icehockeyapi.com/documentation/odds): Odds by date
- [GET /v1/players](https://icehockeyapi.com/documentation/players): List players
- [GET /v1/players/{player_id}](https://icehockeyapi.com/documentation/player): One player
- [GET /v1/players/{player_id}/seasons](https://icehockeyapi.com/documentation/player-seasons): Career
- [GET /v1/players/{player_id}/games](https://icehockeyapi.com/documentation/player-games): Game log
- [GET /v1/players/{player_id}/awards](https://icehockeyapi.com/documentation/player-awards): Awards
- [GET /v1/draft/{year}](https://icehockeyapi.com/documentation/draft): Draft
- [GET /v1/venues](https://icehockeyapi.com/documentation/venues): List venues
- [GET /v1/venues/{venue_id}](https://icehockeyapi.com/documentation/venue): One venue
- [GET /v1/venues/{venue_id}/games](https://icehockeyapi.com/documentation/venue-games): Venue games