NHL API
A hockey API for the NHL: get the schedule, live scores with the period and clock on paid plans, final scores by period with overtime and shootout results, standings with points and wild-card positions, and every team's roster. The free plan covers the current season's schedule, final scores, standings and rosters.
The NHL is served by the Hockey API (league=nhl is the default, so no league parameter is needed). The same API key works for every sports API.
NHL data at a glance
| Season value | season=2026 is the 2026-27 season |
|---|---|
| Scoring | Goals by period in period_scores, with each overtime period |
| Overtime and shootouts | decided_in is regulation, overtime or shootout. A shootout win counts in the final score but not in any period |
| Live games | On paid plans: score, period, clock and intermission breaks |
| Rosters | Forwards, defensemen and goalies with position, sweater number, shoots or catches, height, weight and birthplace |
| Former teams | The Atlanta Thrashers and Arizona Coyotes appear in past seasons (active=false in /v1/hockeyteams); earlier seasons show the Phoenix Coyotes and Utah Hockey Club names |
NHL standings fields
points, point_pct, wins, losses, ot_losses, regulation_wins, goals_for, goals_against, streak, last_10, home and road records, wildcard_rank and clinched.
https://api.api-ninjas.com/v1/hockeygames
Returns schedules, live scores and final scores. Ask for one day, a team's season or one game; with no parameters you get today's games. Paid plans see games in progress with the score, period and clock updated throughout the game; the free plan sees their status and the final score once they end. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Full parameter and response reference: /v1/hockeygames.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
cURL
Python
JavaScript
Node.js
Java
Swift
TypeScript
PHP
C#
Ruby
Go
Kotlin
Rust
React
Vue
Angular
Laravelcurl -X GET "https://api.api-ninjas.com/v1/hockeygames" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/hockeystandings
Returns the league table for a season, ordered by league rank, or by conference or division rank when you filter. Tables update throughout the season, shortly after each game ends. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Full parameter and response reference: /v1/hockeystandings.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/hockeystandings" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/hockeyteams
Lists teams with their league, conference, division and home venue. Available on every plan.
Full parameter and response reference: /v1/hockeyteams.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/hockeyteams" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/hockeyplayers
Returns current rosters and player profiles, by team or by name. Rosters refresh every day. Available on every plan.
Full parameter and response reference: /v1/hockeyplayers.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/hockeyplayers?team=TOR" \
-H "X-Api-Key: YOUR_API_KEY"Frequently Asked Questions
Can I use the NHL API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the NHL API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the NHL API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the NHL API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.Is there an official NHL API?
The NHL does not publish a documented, supported API for developers. The API Ninjas Hockey API provides NHL schedules, live and final scores, standings and rosters withleague=nhl. API Ninjas is not affiliated with or endorsed by the NHL.How are overtime and shootouts reported?
Final games havedecided_inset toregulation,overtimeorshootout.period_scoreslists goals for each period played, including overtime. Shootout goals are not period goals, so a shootout win shows in the final score but not in any period.Do the standings include points and wild cards?
Yes:points,point_pct,regulation_wins,ot_losses,wildcard_rankand the league'sclinchedindicator, plus division, conference and league ranks.How do I get a team's NHL schedule?
Call/v1/hockeygames?team=nhl-tor(orleague=nhl&team=TOR) for the team's current season, with scores for the games already played. Results come 50 games per page; addoffset=50for the rest, or uselimiton paid plans.
Explore API integration use cases for recommended APIs and workflow examples.
API Ninjas is not affiliated with or endorsed by the NFL, the NBA, the NHL, the NCAA or any other league, conference, competition, school or team. League, competition and team names are trademarks of their owners and are used only to identify them.