get https://api.sportradar.com/nhl//v7//games//shot_zones.
NHL Game Shot Zones provides goals, shots, saves, shooting percentage, shots faced, total shot attempts, and other game statistics for players in each zone.
Log in to see full request history
Update Frequency
TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime
Data Points
League:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | season | GUID | Unique ID of a game's season ex. 5d08ca09-ec49-4559-9c0f-257c0158e57f |
type | season | String | Season type for a gameREG (Regular Season), PST (Postseason), PRE (Preseason) |
year | season | Integer | Year of a game's season2022 = 2022-23 Season |
Boxscore:
Attribute | Parent Element | Type | Description |
---|---|---|---|
end_time | game | dateTime | Timestamp of the end of a game ex. 2022-12-06T06:09:52+00:00 |
start_time | game | dateTime | Timestamp of the start of a game ex. 2022-12-06T03:38:31+00:00 |
attendance | game | Integer | Attendance of a game ex. 18420 |
points | team | Integer | Total points for a team |
id | team | GUID | Unique ID of a team ex. 4415b0a7-0f24-11e2-8525-18a905767e44 |
market | team | String | Market name of a team ex. Vancouver |
name | team | String | Team name ex. Canucks |
reference | team | String | League reference ID of a team ex. 23 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3692 |
home | team | Boolean | Signifies the home team when true |
strength | team | String | Current strength of a teameven , shorthanded , powerplay |
total_game_duration | game | String | Duration of a game (in game time) ex. 60:13 |
clock | game | String | Clock value of the game ex. 5:37 |
period | game | Integer | Current period of a game |
number | team - scoring - period | Integer | Period number |
points | team - scoring - period | Integer | Team points in a period |
sequence | team - scoring - period | Integer | Period sequence number |
number | team - scoring - overtime | Integer | Overtime number |
points | team - scoring - overtime | Integer | Team points in overtime |
sequence | team - scoring - overtime | Integer | Period sequence number (The first overtime sequence would be 4 ) |
number | team - scoring - shootout | Integer | Shootout number |
points | team - scoring - shootout | Integer | Team points in shootout |
sequence | team - scoring - shootout | Integer | Shootout sequence number (The first shootout sequence after overtime would be 5 ) |
Game:
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_team | game | GUID | Unique ID of the away team ex. 4416091c-0f24-11e2-8525-18a905767e44 |
coverage | game | String | Coverage level of a gamefull , boxscore |
entry_mode | game | String | Type of data entry for the gameINGEST (Ingested data from the league), LDE (Sportradar live data entry) |
home_team | game | GUID | Unique ID of the home team ex. 44157522-0f24-11e2-8525-18a905767e44 |
id | game | GUID | Unique ID of a game ex. 10b9ce0f-fd31-4d1f-828b-4f20d628f14f |
reference | game | String | League reference ID of a game ex. 20393 |
scheduled | game | dateTime | Scheduled date and time of a game ex. 2022-12-04T20:00:00Z |
sr_id | game | GUID | Unique Sportradar ID of a game ex. sr:match:34542743 |
status | game | String | The status of a gamescheduled , created , inprogress , complete , closed , cancelled , delayed , postponed , time-tbd , if-necessary , unnecessary Please see our FAQ section for a list of game status definitions |
away | game - time_zones | String | Time zone of the away team ex. US/Pacific |
home | game - time_zones | String | Time zone of the home team ex. US/Eastern |
venue | game - time_zones | String | Time zone of the venue ex. US/Eastern |
title | game | String | Title of a game ex. Game 3 |
Game Danger Zone Statistics (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
saves_pct | player - goaltending - danger_zone | Decimal | Save percentage in a danger zone ex. 0.667 |
saves | player - goaltending - danger_zone | Integer | Number of saves in a danger zone |
shots_against | player - goaltending - danger_zone | Integer | Number of shots against in a danger zone |
goals_against | player - goaltending - danger_zone | Integer | Number of goals against in a danger zone |
name | player - goaltending - danger_zone | String | Name of a danger zonedanger_low , danger_medium , danger_high |
shots_attempts | player - statistics - danger_zone | Integer | Number of shot attempts in a danger zone |
shooting_pct | player - statistics - danger_zone | Decimal | Shooting percentage in a danger zone |
blocked_attempts | player - statistics - danger_zone | Integer | Number of blocked attempts (offense) in a danger zone |
missed_shots | player - statistics - danger_zone | Integer | Number of missed shots in a danger zone |
shots | player - statistics - danger_zone | Integer | Number of shots in a danger zone |
goals | player - statistics - danger_zone | Integer | Number of goals in a danger zone |
Game Shot Zone Statistics (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
saves_pct | player - goaltending - shot_zone | Decimal | Save percentage in a shot zone ex. 0.667 |
saves | player - goaltending - shot_zone | Integer | Number of saves in a shot zone |
shots_against | player - goaltending - shot_zone | Integer | Number of shots against in a shot zone |
goals_against | player - goaltending - shot_zone | Integer | Number of goals against in a shot zone |
name | player - goaltending - shot_zone | String | Name of a shot zonedefensive_zone , neutral_zone , center_point , left_point , right_point , low_center_point , low_left_point , low_right_point , outside_right_circle , inside_right_circle , high_slot , inside_left_circle , outside_left_circle , low_right , right_slot , slot , left_slot , low_left , low_slot , down_low |
shots_attempts | player - statistics - shot_zone | Integer | Number of shot attempts in a shot zone |
shooting_pct | player - statistics - shot_zone | Decimal | Shooting percentage in a shot zone |
blocked_attempts | player - statistics - shot_zone | Integer | Number of blocked attempts (offense) in a shot zone |
missed_shots | player - statistics - shot_zone | Integer | Number of missed shots in a shot zone |
shots | player - statistics - shot_zone | Integer | Number of shots in a shot zone |
goals | player - statistics - shot_zone | Integer | Number of goals in a shot zone |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
captain | player | Boolean | Type of team captainC (Team Captain), A (Alternate Captain), N (Not a captain) |
first_name | player | String | First name of a player ex. Sidney |
full_name | player | String | Full name of a player ex. Sidney Crosby |
handedness | player | String | Dominant hand of a player ex. L , R |
id | player | GUID | Unique ID of a player ex. 433de553-0f24-11e2-8525-18a905767e44 |
jersey_number | player | Integer | Number of a player's jersey |
last_name | player | String | Last name of a player ex. Crosby |
played | player | Boolean | Signifies a player appeared in a game |
scratched | player | Boolean | Signifies a player was scratched from a game |
scratched | player | Boolean | Signifies a player started a game |
name_suffix | player | String | Suffix of a player ex. Jr. |
position | player | String | Position of a playerNA , D , F , F-D , G |
primary_position | player | String | Primary position of a playerNA , C , D , G , LW , RW |
reference | player | String | League reference ID of a player ex. 8471675 |
sr_id | player | GUID | Unique Sportradar ID of a player ex. sr:player:31007 |
Player Injuries:
Attribute | Parent Element | Type | Description |
---|---|---|---|
comment | player - injury | String | Text description of an injury ex. "Demko is expected to miss the next six weeks of action, according to Elliotte Friedman of sportsnet.ca." |
desc | player - injury | String | Brief description of an injury ex. Lower-Body |
id | player - injury | GUID | Unique ID of an injury ex. 68a440e4-6ce3-48d7-a299-52412e10c7b7 |
start_date | player - injury | Date | Date an injury transaction goes into effect ex. 2022-12-02 |
status | player - injury | String | Status of an injuryUnknown , Day To Day , Out , Out for Season , Out Indefinitely |
update_date | player - injury | Date | Date of an injury update ex. 2022-12-03 |
Officials:
Attribute | Parent Element | Type | Description |
---|---|---|---|
assignment | official | Integer | Official assignment ex. Linesman or Referee |
experience | official | String | Number of years officiated in the NHL |
first_name | official | String | First name of an official ex. Brian |
full_name | official | String | Full name of an official ex. Brian Pochmara |
id | official | GUID | Unique ID of an official ex. 72fae8f3-6e07-45ba-a0fd-31d51d1ed90b |
last_name | official | String | Last name of an official ex. Pochmara |
number | official | Integer | Number of an official's jersey |
reference | official | String | NHL ID of an official |
Team:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | team | GUID | Unique ID of a team ex. bdc11650-6f74-49c4-875e-778aeb7632d9 |
market | team | String | Market name of a team ex. Minnesota |
name | team | String | Team name ex. Wild |
reference | team | String | League reference ID of a team ex. 30 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3689 |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
address | venue | String | Address of a venue ex. 2500 Victory Avenue |
capacity | venue | String | Capacity of a venue ex. 18532 |
city | venue | String | City of a venue ex. Dallas |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. adbd1acb-a053-4944-ba15-383eda91c12e |
lat | venue - location | Decimal | Latitude of a venue ex. 44.94478 |
lng | venue - location | Decimal | Longitude of a venue ex. -93.10118 |
name | venue | String | Name of a venue ex. American Airlines Center |
sr_id | venue | GUID | Unique Sportradar ID of a venue ex. sr:venue:5988 |
state | venue | String | State or province of a venue ex. TX |
time_zone | venue | String | Time zone of the venue ex. US/Central |
zip | venue | Integer | ZIP code of a venue ex. 75219 |
Response