---
seo:
  description: >-
    Read-only access to Hockay's public data: seasons, teams, players, games,
    standings, the bracket, and the league's reference tables.
sidebar:
  label: Overview
title: Hockay API
---
Read-only access to Hockay's public data: seasons, teams, players, games, standings, the bracket, and the league's reference tables.

Send your key in the `x-api-key` header (or as `Authorization: Bearer <key>`). Keys are an early-access perk for sociétaires; see https://hockay.com/docs.

Limits are per key, counted over 60 seconds (app 300/min, standard 300/min, plus 600/min, max 1200/min). Every response carries RateLimit-Policy; a 429 carries Retry-After.

Nothing is served before it airs: events follow the broadcast, box scores and commentary wait for the final horn, and injuries appear when they are announced.

Version 1

Base URL: `https://hockay.com/api/v1`

## Seasons

- [`GET /seasons`](/docs/reference/seasons/list-seasons) — Every season, newest first.
- [`GET /seasons/{id}`](/docs/reference/seasons/get-season) — One season.
- [`GET /seasons/{id}/matchdays`](/docs/reference/seasons/list-matchdays) — A season's nights, in calendar order.

## Teams

- [`GET /teams`](/docs/reference/teams/list-teams) — The league's teams.
- [`GET /teams/{id}`](/docs/reference/teams/get-team) — One team, its roster, and its rivalries.

## Players

- [`GET /players`](/docs/reference/players/list-players) — Players, by name.
- [`GET /players/{id}`](/docs/reference/players/get-player) — One player.
- [`GET /players/{id}/stats`](/docs/reference/players/get-player-stats) — A player's season lines.
- [`GET /players/{id}/games`](/docs/reference/players/get-player-games) — A player's last final games.
- [`GET /players/{id}/modifiers`](/docs/reference/players/get-player-modifiers) — Modifiers a player gained and lost.
- [`GET /leaders`](/docs/reference/players/get-leaders) — One season's leaders for one stat.

## Games

- [`GET /games`](/docs/reference/games/list-games) — A season's games, in start order.
- [`GET /games/{id}`](/docs/reference/games/get-game) — One game.
- [`GET /games/{id}/events`](/docs/reference/games/get-game-events) — A game's aired events, in broadcast order.
- [`GET /games/{id}/boxscore`](/docs/reference/games/get-game-box-score) — Player lines, totals, and lineups.
- [`GET /games/{id}/commentary`](/docs/reference/games/get-game-commentary) — JM's commentary.
- [`GET /live`](/docs/reference/games/get-live-scores) — Games in progress.

## Standings

- [`GET /standings`](/docs/reference/standings/get-standings) — The table.
- [`GET /standings/history`](/docs/reference/standings/get-standings-history) — The table after each matchday.
- [`GET /playoffs`](/docs/reference/standings/get-playoffs) — The bracket.
- [`GET /injuries`](/docs/reference/standings/get-injuries) — Running injuries that have aired.

## League

- [`GET /arenas`](/docs/reference/league/list-arenas) — Arenas and neutral sites.
- [`GET /arenas/{slug}`](/docs/reference/league/get-arena) — One arena or neutral site.
- [`GET /modifiers`](/docs/reference/league/list-modifiers) — Modifiers' names and descriptions.
- [`GET /rivalries`](/docs/reference/league/get-rivalries) — League rivalries and the most despised.