Subscriptions to the Elite Prospects API are scoped along a few dimensions. This page explains the choices so you know what your plan includes and what an upgrade unlocks.
If you’re unsure what your current subscription covers, or want to expand it, contact [email protected].
Regional coverage
Subscriptions cover one or more regions. Each region is defined by the leagues it contains — a Finnish team playing in the KHL counts as Russia & East (where the KHL belongs), not Nordics (where the team is based).
| Region | Coverage |
|---|
| North America | USA, Canada — NHL, AHL, ECHL, CHL (WHL/OHL/QMJHL), USHL, NCAA, and other US/Canadian leagues |
| Nordics | Sweden, Finland, Norway, Denmark, Iceland — SHL, Liiga, HockeyAllsvenskan, Mestis, and more |
| Central Europe | Germany, Switzerland, Austria, Czechia, Slovakia, Poland, Hungary, France, UK, Netherlands, Belgium — DEL, NL, ICEHL, Extraliga, and more |
| Russia & East | Russia, Belarus, Ukraine, Kazakhstan, Latvia, Lithuania, Estonia — KHL, VHL, MHL, and more |
| Rest of World | All countries not in another geographic region |
| International | Cross-border tournaments — World Juniors, Olympics, World Championships, Hlinka Gretzky Cup, and more |
| Global | All geographic regions combined |
International is a separate subscription. Global covers every league worldwide but does not include international tournaments. To see World Juniors, Olympics, and other IIHF events, add International to your subscription.
How regional coverage affects responses
- List endpoints only return records from leagues in your covered regions.
- Single-resource endpoints for leagues, teams, games, transfers, draft selections, and staff outside your coverage return
403 Forbidden.
- Player records outside your coverage return a basic profile (name, nationality, date of birth, position) — full stats and related data require coverage of the player’s current league.
Historical depth
Historical depth controls how many past seasons of stats, games, transfers, draft history, and awards are returned. Upcoming seasons (next five) are always visible regardless of tier.
| Tier | What you see |
|---|
| Current season | Only the season in progress |
| Recent | Current season plus the four prior |
| Deep | Current season plus the nineteen prior |
| All time | The full history |
Once a player is included in your regional coverage, their career stats across all leagues they’ve played in are subject only to your historical depth tier — historical access isn’t restricted to the regions you’ve subscribed to.
Optional data categories
Some endpoint families are optional add-ons:
| Category | What it includes |
|---|
| Game data | Live and historical games, game logs, and aggregated game-log statistics |
| Drafts | Draft events, selections, and rankings |
| Transfers | Player transfer history |
| Staff | Coaches and other staff, including their stats and awards |
| Scouting reports | Player scouting reports |
A subscription without one of these categories returns 403 Forbidden for the corresponding routes.
Youth hockey
Youth and junior leagues — Bantam, Midget, Junior A / Major Junior, WJC-eligible competitions, High School, Prep, and similar tiers — are an optional inclusion. Without it, youth leagues, teams, games, and players are not returned.
Women’s hockey
Women’s leagues, teams, female players, and women’s-league games, transfers, and draft selections are an optional inclusion. Without it, this data is not returned.
Free plan
The free plan provides basic lookups for players, teams, and leagues, with a reduced set of fields per record. It’s intended for evaluation and lightweight integrations. Endpoints outside that lookup set, and richer fields on the included endpoints, require a paid plan.
Working out why you got a 403
The most common reasons a request returns 403 Forbidden:
- The endpoint family isn’t included in your plan (e.g. game data, transfers, scouting reports).
- The record is in a region you don’t cover.
- An explicit
season or year parameter is older than your historical depth allows.
- The record is in a youth or women’s league and those aren’t included.
- The endpoint isn’t part of the free plan.
If you need access to data you’re seeing this for, contact [email protected].