Game Shot Zones

⏱️
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 game `REG` (Regular Season), `PST` (Postseason), `PRE` (Preseason)
`year`	`season`	Integer	Year of a game's season `2022` = 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 team `even`, `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 game `full`, `boxscore`
`entry_mode`	`game`	String	Type of data entry for the game `INGEST` (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 game `scheduled`, `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 zone `danger_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 zone `defensive_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 captain `C`(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
`starter`	`player`	Boolean	Signifies a player started a game
`name_suffix`	`player`	String	Suffix of a player ex. `Jr.`
`position`	`player`	String	Position of a player `NA`, `D`, `F`, `F-D`, `G`
`primary_position`	`player`	String	Primary position of a player `NA`, `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 injury `Unknown`, `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`