Get started with NHL v6
Alert
Please note that the current, stable version of our NHL API is v7. We suggest integrating with this version.
API Map
To best utilize the NHL API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.
Data Retrieval Examples
To find a players assists for a given game:
- Call the schedule or daily schedule and find the Game Id for the chosen game
- Call the Game Boxscore using the Game Id
- Find the assists statistics and locate the player full_name
The number of the players's assists is displayed.
To find the coach's name for a given team:
- Call the season or series schedule and find id for the coach's team
- Call the Team Profile using the Team ID
- Find the coach element and locate the full_name attribute
The coach's full name is displayed.
Coverage Levels
We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.
Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team- and player-level data in near real time. Full coverage is available for all regular and postseason games as well as those preseason games available live via a broadcast.
Boxscore – We provide scores and time remaining, in a timely manner, as the game progresses. In-game updates are always subject to availability of sources. Boxscore coverage is available for any preseason game that is not in an NHL venue, as those games are not covered by NHL statisticians.
Integration Links
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NHL API collection. Please note that this collection is specific to the current version (v7).
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire NHL API XSD schema.
Data Entry Workflow
Sunday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Transactions (All Day)
Monday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Season Stats Validation (All Day)
Transactions (All Day)
Tuesday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Season Stats Validation (All Day)
Transactions (All Day)
Wednesday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Season Stats Validation (All Day)
Transactions (All Day)
Thursday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Season Stats Validation (All Day)
Transactions (All Day)
Friday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Transactions (All Day)
Saturday
Final Game Times Set for the Day's Games (10am CT)
Injuries (All Day)
Validated Games (60 Minutes after game goes final)
Update NHL Rankings (60 Minutes after the last game goes final)
Transactions (All Day)
Simulations
Our NHL simulations give you the opportunity to test your code against a simulation of live data before the preseason starts or any time! Our simulation system replays select completed games allowing you to view our API feeds as if they were happening live.
Simulations run every day according to the below schedule. Data is reset for each day's simulations at 12:00pm UTC.
Start Time (UTC) | Game | Game ID |
1:00pm | Calgary at Ottawa | 823a317f-8bbe-4e26-8c75-2a05138f3d70 |
1:00pm | Edmonton at Vancouver | 66a5f479-0011-4ead-a51d-33a93e0062f7 |
1:00pm | Montreal at Winnipeg | 8d591315-f3c8-4925-a3f1-d5a23ac8ba55 |
5:00pm | Dallas at Tampa Bay | 90008b6a-3600-45e6-a3c3-21cca49e5d9d |
5:00pm | Pittsburgh at New York | e4ba2be3-6cdc-4434-9194-5694e82c7ef9 |
9:00pm | St. Louis at San Jose | 86bf6496-4a5d-456d-8e63-2cd41bd0373b |
9:00pm | Minnesota at Vegas | c7e64152-06e2-44cc-872f-678fb64714ca |
9:00pm | Colorado at Arizona | d364d4ec-892d-48d0-b44d-40a2e711b174 |
9:00pm | Vegas at Anaheim | dd1f6ad9-733a-4a28-b4a8-955f1fc04cc2 |
To retrieve the game IDs, team IDs, and other associated information for each game listed above, you can use the following URL with the syntax noted below. If you have an existing NHL API key, simply replace the access_level (trial or production) in the URL of a feed with simulation.
Use SIM as the nhl_season and 2020 as the season_year for each applicable NHL simulation request.
Simulation Parameters
Schedule: https://api.sportradar.com/nhl/simulation/{version}/{language_code}/games/2020/SIM/schedule.{format}?api_key={your_api_key} |
Parameter | Description |
---|---|
version | Version number of the API you are accessing (Current Version: v6). |
language_code | 2 letter code for supported languages: en (English), es (Spanish), fr (French), ru (Russian), and zh (simplified Chinese). |
nhl_season | SIM |
season_year | 2020 |
format | xml or json. |
your_api_key | Your API key. |
Feeds Available: Game Analytics, Game Boxscore, Game Faceoffs, Game Play-By-Play, Game Shot Zones, Game Summary, Game Time on Ice, League Leaders (Goaltending), League Leaders (Skaters), Schedule, Seasonal Analytics, Seasonal Faceoffs, Seasonal Shot Zones, Seasonal Statistics, Standings, Team Profile, Push Events, and Push Statistics.
For syntax structure on each feed, please reference the endpoint documentation.