Skip to main content
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).
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. 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: 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].