NHL v7 Overview

Introduction

As NHL’s official data partner, Sportradar offers the most detailed and complete live NHL data available. This includes official and accurate scoring, faceoffs, substitutions, hits, giveaways, and more. Game analytics and seasonal statistics are also available to provide a robust hockey experience.

The NHL API is consistent in structure, format, and behavior with our other League Specific APIs. Our primary feeds return schedules, standings, team/player data, and real-time scores.

Our other NHL feeds provide a host of complimentary statistics and information, including:

Rankings
League leaders
Injuries
Depth charts
In-game substitution info
Live event positional data
Seasonal statistics
Game analytics
Shot zones
Faceoff statistics

Real-time customers are also offered three delivery Push Feeds to enhance speed.

🗝️
Authentication is required for all API calls.

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.

Endpoint Descriptions

Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.

Daily Schedule – Date, time, location, and other event details for every match-up taking place in the league-defined day.

Daily Transfers – Information for all transfers added or edited during the league-defined day.

Depth Charts – Positional depth chart for a given team, including player position information.

Free Agents – Provides detailed player information for all current free agents in the league.

Game Analytics – Provides detailed team and player analytics for a given game, including corsi, fenwick, on ice shots, and shots by type.

Game Boxscore – Top-level team scores by quarter and full statistics for team leaders in assists, goals, and points.

Game Faceoffs – Detailed faceoff information for teams and players, including period, zone, and strength breakdowns, for a given game.

Game Play-by-Play – Detailed, real-time information on every team possession and game event.

Game Shot Zones – Provides goals, shots, saves, shooting percentage, shots faced, total shot attempts, and other game statistics for players in each zone.

Game Summary – Top-level boxscore information with detailed team and player levels game stats.

Game Time on Ice – Time on ice totals for every player for a given game, including detailed shift information.

Injuries – Information concerning all active player injuries for all teams within the league.

League Hierarchy – Provides top-level information for each team, including conference and division distinction, and venue information.

League Leaders – Daily – NHL daily league leader information for various skater and goaltending categories including points, goals, and plus/minus.

League Leaders – Seasonal – NHL seasonal league leader information for various skater and goaltending categories including points, goals, and plus/minus.

League Leaders – Goaltending – NHL league leader information for various goaltending categories including full player seasonal statistics for each player in each category.

League Leaders – Skaters – NHL league leader information for various skater categories including full player seasonal statistics for each player in each category.

Player Profile – Provides player biographical information, draft information, and seasonal statistics.

Rankings – Conference and division rank for each team, including post season clinching status.

Schedule – Date, time, location, and other event details for every match-up taking place in the full league season.

Seasonal Analytics – Detailed team and player analytics for a given team and season, including corsi, fenwick, on ice shots, and shots by type.

Seasonal Faceoffs – Detailed faceoff information for teams and players, including period, zone, and strength breakdowns, for a given team and season.

Seasonal Shot Zones – Provides goals, shots, saves, shooting percentage, shots faced, total shot attempts, and other seasonal statistics for a player in each zone.

Seasonal Statistics – Detailed team and player statistics for a given team and season.

Seasons – Provides a list of all available seasons.

Series Faceoffs – Detailed faceoff information for teams and players for a given series, including period, zone, and strength breakdowns.

Series Schedule – Playoff participant information and the date, time, location, and other event details for every match-up taking place for the entire playoffs.

Series Statistics – Detailed team and player statistics for the defined series.

Standings – Detailed team records across various views including, overall, conference, and division.

Team Leaders – Daily – NHL daily leader information for various skater and goaltending categories, including full player seasonal statistics for each player in each category.

Team Leaders – Seasonal – NHL seasonal leader information for various skater and goaltending categories, including full player seasonal statistics for each player in each category.

Team Profile – Provides top-level team information and a full roster of active players.

Teams – Provides a complete list of active teams in the NHL API database.

Push Clock – Game clock feed with high level scoring and strength information, including the most recent game event.

Push Events – Detailed, real-time information on every game event.

Push Statistics – Detailed, real-time game stats at the team and player level.

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.

🏒
Preseason Coverage Note:
Preseason games played outside NHL venues feature boxscore coverage, as they are not covered by NHL statisticians. Use the Game Boxscore endpoint for these games.
API data latency varies compared to regular season games. Preseason games often serve as a testing ground, resulting in changes and adjustments to data collection methods. As a result, data updates may not be as timely or consistent as the regular season.

Failover Details

In some rare instances it will be necessary to failover from on-rink NHL game data to in-house Sportradar data entry. NHL data will be reconciled subsequent to the conclusion of the game.

Reference this document for a list of data points lost during a failover.

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.

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.

NHL v7 Schema

Simulations

Check out our Simulationsto replay actual games at any time, on your own schedule.

Data Entry Workflow

See below for a daily breakdown of data updates for the NHL API.

Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Important Dates

Sunday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

Monday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

Tuesday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

Wednesday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

Thursday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

Friday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

Saturday

Final game times set for the day's games (11am ET)
Game stats validated and moved to closed status (60 minutes after game goes final)
Update rankings (60 minutes after the last game goes final)
Season stats validation (all day)
Injuries (all day)*
Transactions (all day)*

* We monitor and update injuries and transactions throughout the day, using a combination of official and reliable sources.

Important Dates

The NHL schedule typically becomes available in July. This release may differ year-to-year depending on seasonal demands.

4 Nations Face-Off FAQ

Will you cover the 4 Nations Face-Off? If so, at what coverage level?

Yes, we will cover the 4 Nations Face-Off games beginning in 2025.

All games are covered in realtime, but statistical coverage will be lower than that of a full coverage game in the NHL API.

What data points are unavailable during these events?

Here is a list of affected data points, sorted by endpoint:

Schedule and Game Endpoints

No sr_id game id (ex. sr:match:49470535)

Game Summary

Time on Ice (time_on_ice) - Will be available post-game
Player Level: captain, starter
Player Statistic Total: ot_game, offensive_zone_starts, defensive_zone_starts, neutral_zone_starts, defensive_zone_starts_pct, offensive_zone_starts_pct, neutral_zone_starts_pct, first_star, second_star, third_star
Player Period Total: number_of_shifts, evenstrength splits, powerplay splits, shorthanded splits, faceoff_win_pct, faceoffs, faceoffs_lost, faceoffs_won, missed_shots, player time_on_ice overtime
Game rosters will be available prior to the start of each game

Game Play-by-Play

No substitution events
No official, shot_type, goal_zone, or on_ice information on an event level
No penalty_code data

Game Analytics

No team and player shot_by_type information

Game Time On Ice

No team and player information by period

What is the format?

Teams representing Canada, Finland, Sweden, and the United States will play each other in a round-robin format, followed by a one-game final between the two top-placed teams.

Games are played on NHL-sized rinks, following NHL rules. For round-robin games, overtime will be held in a 10-minute, 3-on-3 sudden-death period, followed by a three-round shootout. In the final, overtime will be held in consecutive 20-minute, 5-on-5 sudden-death periods.

Visit this NHL page for detailed info on the format of these games.

How do I access the tournament games?

The games can be found in the Daily Schedule or Schedule endpoints.

Daily Schedule: https://api.sportradar.com/nhl/trial/v7/en/games/2025/02/17/schedule.json?api_key=[YOUR_API_KEY
Schedule: https://api.sportradar.com/nhl/trial/v7/en/games/2024/REG/schedule.xml?api_key=[YOUR_API_KEY]

Every game-centric feed (e.g. Game Play-by-Play, Game Summary, Push Events, etc.) can be accessed during the games.

<league xmlns="http://feed.elasticstats.com/schema/hockey/schedule-v6.0.xsd" id="fd560107-a85b-4388-ab0d-655ad022aff7" name="NHL" alias="NHL">
    <daily-schedule date="2025-02-17">
        <games>
            <game id="135c3c0e-2819-46cd-8af7-36f87d96a489" title="Team Canada vs Team Finland" status="scheduled" coverage="full" scheduled="2025-02-17T18:00:00Z" parent_id="9a7ba0e5-77ba-47bc-8de9-0038aa43662d" reference="190005" home_team="8ca3ad35-b16c-47cd-a3f5-678fc45718f1" away_team="2daa7c51-22ba-41ba-97bd-a920782b8541">
                <venue id="854ca968-b25f-44f9-abc5-52bcf8825f15" name="TD Garden" capacity="17565" address="100 Legends Way" city="Boston" state="MA" zip="02114" country="USA" time_zone="US/Eastern" sr_id="sr:venue:5940">
                    <location lat="42.36618" lng="-71.06211"/>
                </venue>
                <time_zones venue="US/Eastern"/>
                <home id="8ca3ad35-b16c-47cd-a3f5-678fc45718f1" name="Team Finland" alias="FIN">
        </home>
                <away id="2daa7c51-22ba-41ba-97bd-a920782b8541" name="Team Canada" alias="CAN">
        </away>
                <broadcasts>
                    <broadcast network="TNT" type="TV" locale="National" channel="245"/>
                    <broadcast network="truTV" type="TV" locale="National" channel="246"/>
                    <broadcast network="Max" type="Internet" locale="National"/>
                </broadcasts>
            </game>
            <game id="c85f49c9-fa9e-442a-9e9e-d491350e304c" title="Team Sweden vs Team USA" status="scheduled" coverage="full" scheduled="2025-02-18T01:00:00Z" parent_id="9a7ba0e5-77ba-47bc-8de9-0038aa43662d" reference="190006" home_team="31a76837-ac41-4af0-ae6a-5d058b7e5626" away_team="23ba9bca-71b5-4ce0-ace4-d2ef1cea9607">
                <venue id="854ca968-b25f-44f9-abc5-52bcf8825f15" name="TD Garden" capacity="17565" address="100 Legends Way" city="Boston" state="MA" zip="02114" country="USA" time_zone="US/Eastern" sr_id="sr:venue:5940">
                    <location lat="42.36618" lng="-71.06211"/>
                </venue>
                <time_zones venue="US/Eastern"/>
                <home id="31a76837-ac41-4af0-ae6a-5d058b7e5626" name="Team USA" alias="USA">
        </home>
                <away id="23ba9bca-71b5-4ce0-ace4-d2ef1cea9607" name="Team Sweden" alias="SWE">
        </away>
                <broadcasts>
                    <broadcast network="TNT" type="TV" locale="National" channel="245"/>
                    <broadcast network="truTV" type="TV" locale="National" channel="246"/>
                    <broadcast network="Max" type="Internet" locale="National"/>
                </broadcasts>
            </game>
        </games>
    </daily-schedule>
</league>

{
    "date": "2025-02-17",
    "league": {
        "id": "fd560107-a85b-4388-ab0d-655ad022aff7",
        "name": "NHL",
        "alias": "NHL"
    },
    "games": [
        {
            "id": "135c3c0e-2819-46cd-8af7-36f87d96a489",
            "title": "Team Canada vs Team Finland",
            "status": "scheduled",
            "coverage": "full",
            "scheduled": "2025-02-17T18:00:00Z",
            "parent_id": "9a7ba0e5-77ba-47bc-8de9-0038aa43662d",
            "reference": "190005",
            "time_zones": {
                "venue": "US/Eastern",
                "home": null,
                "away": null
            },
            "venue": {
                "id": "854ca968-b25f-44f9-abc5-52bcf8825f15",
                "name": "TD Garden",
                "capacity": 17565,
                "address": "100 Legends Way",
                "city": "Boston",
                "state": "MA",
                "zip": "02114",
                "country": "USA",
                "time_zone": "US/Eastern",
                "sr_id": "sr:venue:5940",
                "location": {
                    "lat": "42.36618",
                    "lng": "-71.06211"
                }
            },
            "broadcasts": [
                {
                    "network": "TNT",
                    "type": "TV",
                    "locale": "National",
                    "channel": "245"
                },
                {
                    "network": "truTV",
                    "type": "TV",
                    "locale": "National",
                    "channel": "246"
                },
                {
                    "network": "Max",
                    "type": "Internet",
                    "locale": "National"
                }
            ],
            "home": {
                "id": "8ca3ad35-b16c-47cd-a3f5-678fc45718f1",
                "name": "Team Finland",
                "alias": "FIN"
            },
            "away": {
                "id": "2daa7c51-22ba-41ba-97bd-a920782b8541",
                "name": "Team Canada",
                "alias": "CAN"
            }
        },
        {
            "id": "c85f49c9-fa9e-442a-9e9e-d491350e304c",
            "title": "Team Sweden vs Team USA",
            "status": "scheduled",
            "coverage": "full",
            "scheduled": "2025-02-18T01:00:00Z",
            "parent_id": "9a7ba0e5-77ba-47bc-8de9-0038aa43662d",
            "reference": "190006",
            "time_zones": {
                "venue": "US/Eastern",
                "home": null,
                "away": null
            },
            "venue": {
                "id": "854ca968-b25f-44f9-abc5-52bcf8825f15",
                "name": "TD Garden",
                "capacity": 17565,
                "address": "100 Legends Way",
                "city": "Boston",
                "state": "MA",
                "zip": "02114",
                "country": "USA",
                "time_zone": "US/Eastern",
                "sr_id": "sr:venue:5940",
                "location": {
                    "lat": "42.36618",
                    "lng": "-71.06211"
                }
            },
            "broadcasts": [
                {
                    "network": "TNT",
                    "type": "TV",
                    "locale": "National",
                    "channel": "245"
                },
                {
                    "network": "truTV",
                    "type": "TV",
                    "locale": "National",
                    "channel": "246"
                },
                {
                    "network": "Max",
                    "type": "Internet",
                    "locale": "National"
                }
            ],
            "home": {
                "id": "31a76837-ac41-4af0-ae6a-5d058b7e5626",
                "name": "Team USA",
                "alias": "USA"
            },
            "away": {
                "id": "23ba9bca-71b5-4ce0-ace4-d2ef1cea9607",
                "name": "Team Sweden",
                "alias": "SWE"
            }
        }
    ]
}

When will rosters be available?

Game rosters will be available shortly prior to each game beginning.

Please note that we only provide game rosters (not team rosters) for each game. Request the Game Summary endpoint prior to the game to receive rosters.

Will standings be available?

No, standings for the 4 Nations Face-Off is not supported in the NHL API.

Will the games be supported in the Push feeds?

Yes, Push feeds will be available while each game is live.

Are the games covered in the Global Ice Hockey API?

Yes. See our Coverage Matrix for detail on coverage levels.

What will a goal event look like in the Game Play-by-Play endpoint?

Here is an example of a goal event to expect:

{ 
   "id":"57075370-8328-4bdb-ab4c-f42433112169", 
   "clock":"13:53", 
   "updated":"2025-02-06T01:13:56Z", 
   "wall_clock":"2025-02-06T01:+1:10Z", 
   "description":"Goal scored by Artemi Panarin assisted by Mika Zibanejad", 
   "clock_decimal":"13:53", 
   "sequence":1738804330798, 
   "home_points":1, 
   "away_points":0, 
   "strength":"even", 
   "zone":"offensive", 
   "event_type":"goal", 
   "attribution":{ 
      "id":"441781b9-0f24-11e2-8525-18a905767e44", 
      "name":"Rangers", 
      "market":"New York", 
      "team_goal":"left", 
      "sr_id":"sr:team:3701", 
      "reference":"3" 
   }, 
   "location":{ 
      "coord_x":1887, 
      "coord_y":680, 
      "action_area":"insiderightcircle" 
   }, 
   "details":{ 
      "distance":146 
   }, 
   "statistics":[ 
      { 
         "goal":true, 
         "type":"shot", 
         "strength":"even", 
         "zone":"offensive", 
         "team":{ 
            "id":"441781b9-0f24-11e2-8525-18a905767e44", 
            "name":"Rangers", 
            "market":"New York", 
            "sr_id":"sr:team:3701", 
            "reference":"3" 
         }, 
         "player":{ 
            "id":"019e74ad-95fb-478a-bff7-b549fceadabf", 
            "full_name":"Artemi Panarin", 
            "jersey_number":"10", 
            "sr_id":"sr:player:104807", 
            "reference":"8478550" 
         } 
      }, 
      { 
         "type":"assist", 
         "strength":"even", 
         "zone":"offensive", 
         "assist_type":"primary", 
         "team":{ 
            "id":"441781b9-0f24-11e2-8525-18a905767e44", 
            "name":"Rangers", 
            "market":"New York", 
            "sr_id":"sr:team:3701", 
            "reference":"3" 
         }, 
         "player":{ 
            "id":"42f5f2cc-0f24-11e2-8525-18a905767e44", 
            "full_name":"Mika Zibanejad", 
            "jersey_number":"93", 
            "sr_id":"sr:player:145201", 
            "reference":"8476459" 
         } 
      }, 
      { 
         "saved":false, 
         "goal":true, 
         "type":"shotagainst", 
         "strength":"even", 
         "zone":"defensive", 
         "team":{ 
            "id":"4416ba1a-0f24-11e2-8525-18a905767e44", 
            "name":"Bruins", 
            "market":"Boston", 
            "sr_id":"sr:team:3677", 
            "reference":"6" 
         }, 
         "player":{ 
            "id":"9dd8b7c0-36dc-4a48-bcc7-5ac043f7883c", 
            "full_name":"Joonas Korpisalo", 
            "jersey_number":"70", 
            "sr_id":"sr:player:350688", 
            "reference":"8476914", 
            "goals_against":3 
         } 
      } 
   ] 
},

All-Star Game FAQ

How do I locate the All-Star game(s)?

The games can be found in the Daily or League Schedule endpoint. For example: nhl/trial/v7/en/games/2022/02/05/schedule

Every game-centric feed (e.g. Game Play-by-Play, Game Summary, Push Events, etc) can be accessed during the games.

Click here for a Game Summary or Game Play-by-Play sample of the 2022 games.

What are the differences from a typical NHL game?

There are three total games played for the NHL All-Star break. Two semifinal games (teams for each of the 4 NHL divisions), with the winner of each game advancing to the final game. All three games appear in the Daily Schedule or League Schedule endpoint.

All three games are three-on-three, with two 10-minute periods.

Are the All-Star games covered in realtime?

Yes, all three games are covered in realtime, including the same level of team and player statistics as a regular season game.

When are the All-Star rosters set?

All-Star game rosters will be available shortly prior to each game beginning.

Please note that we only provide game rosters (not team rosters) for each game. Request the Game Summary endpoint prior to the game to receive rosters.

Do you cover the Skills competition?

No. We do not currently cover the All-Star Skills competition in the NHL API.

NHL v7 Overview

Introduction

🗝️
Authentication is required for all API calls.

API Map

Endpoint Descriptions

Data Retrieval Examples

Coverage Levels

🏒
Preseason Coverage Note:

Failover Details

Integration Links

Postman Workspace

Schema Download

Simulations

Data Entry Workflow

Sunday

Monday

Tuesday

Wednesday

Thursday

Friday

Saturday

Important Dates

4 Nations Face-Off FAQ

Will you cover the 4 Nations Face-Off? If so, at what coverage level?

What data points are unavailable during these events?

What is the format?

How do I access the tournament games?

When will rosters be available?

Will standings be available?

Will the games be supported in the Push feeds?

Are the games covered in the Global Ice Hockey API?

What will a goal event look like in the Game Play-by-Play endpoint?

All-Star Game FAQ

How do I locate the All-Star game(s)?

What are the differences from a typical NHL game?

Are the All-Star games covered in realtime?

When are the All-Star rosters set?

Do you cover the Skills competition?

Introduction

🗝️Authentication is required for all API calls.

API Map

Endpoint Descriptions

Data Retrieval Examples

Coverage Levels

🏒Preseason Coverage Note:

Failover Details

Integration Links

Postman Workspace

Schema Download

Simulations

Data Entry Workflow

Sunday

Monday

Tuesday

Wednesday

Thursday

Friday

Saturday

Important Dates

4 Nations Face-Off FAQ

Will you cover the 4 Nations Face-Off? If so, at what coverage level?

What data points are unavailable during these events?

What is the format?

How do I access the tournament games?

When will rosters be available?

Will standings be available?

Will the games be supported in the Push feeds?

Are the games covered in the Global Ice Hockey API?

What will a goal event look like in the Game Play-by-Play endpoint?

All-Star Game FAQ

How do I locate the All-Star game(s)?

What are the differences from a typical NHL game?

Are the All-Star games covered in realtime?

When are the All-Star rosters set?

Do you cover the Skills competition?

🗝️
Authentication is required for all API calls.

🏒
Preseason Coverage Note: