⏱️
Update Frequency
TTL / Cache:

60 seconds when a game is in scheduled status

3 seconds when a game moves to inprogress

600 seconds when a game moves to closed

4 hours when seven days have passed since closed

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`)
`id`	`player` - `periods` - `period`	GUID	Unique ID of a period ex. `84d1303d-6493-4db9-a827-b4a83bdc656a`
`type`	`player` - `periods` - `period`	String	Type of period ex. `REG`, `OT`
`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`)

Team Leaders

Note: Leaders appear under each team for points, goals, and assists.

Attribute	Parent Element	Type	Description
`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
`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`

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`
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like the Stanley Cup) across seasons.
`reference`	`game`	String	League reference ID of a game ex. `20393`
`scheduled`	`game`	dateTime	Scheduled date and time of a game ex. `2026-04-17T02:30:00+00:00`
`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
`channel`	`broadcast`	String	Name of a game's broadcast channel ex. `215`
`locale`	`broadcast`	String	Signifies the locale of a broadcast ex. `Home`, `Away`, `National`, `International`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `NHL Network`
`type`	`broadcast`	String	Type of broadcast ex. `TV`
`url`	`broadcast`	String	Website URL of a game
`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`

Team Records

Team record data is added after a game moves to closed status. It is not present prior to or during a game.

Attribute	Parent Element	Type	Description
`losses`	`team` - `record`	Integer	Number of team losses year-to-date after a game
`overtime_losses`	`team` - `record`	Integer	Number of team overtime losses year-to-date after a game
`wins`	`team` - `record`	Integer	Number of team wins year-to-date after a game

Game Statistics (Player)

Attribute	Parent Element	Type	Description
`assists`	`player` - `statistics`	Integer	Number of assists
`avg`	`player` - `time_on_ice`	String	Average time on ice in seconds ex. `00:44`
`blocked_att`	`player` - `statistics`	Integer	Number of blocked attempts (i.e. player's shot was blocked)
`blocked_shots`	`player` - `statistics`	Integer	Number of blocked shots (i.e. player blocked a shot)
`emptynet_goals`	`player` - `statistics`	Integer	Number of empty net goals
`assists`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength assists
`faceoff_win_pct`	`player` - `statistics` - `evenstrength`	Decimal	Even strength faceoff win percentage
`faceoffs`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength faceoffs
`faceoffs_lost`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength faceoffs lost
`faceoffs_won`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength faceoffs won
`goals`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength goals
`missed_shots`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength missed shots
`shots`	`player` - `statistics` - `evenstrength`	Integer	Number of even strength shots on goal
`evenstrength`	`player` - `time_on_ice`	String	Even strength time on ice in seconds ex. `13:21`
`faceoff_win_pct`	`player` - `statistics`	Decimal	Faceoff win percentage ex. `46.7`
`faceoffs`	`player` - `statistics`	Integer	Number of faceoffs
`faceoffs_lost`	`player` - `statistics`	Integer	Number of faceoffs lost
`faceoffs_won`	`player` - `statistics`	Integer	Number of faceoffs won
`winning_goal`	`player` - `statistics`	Boolean	Signifies the player made the winning goal in a game
`first_star`	`player` - `statistics`	Integer	Signifies the player received the first star for a game when `1`
`second_star`	`player` - `statistics`	Integer	Signifies the player received the second star for a game when `1`
`third_star`	`player` - `statistics`	Integer	Signifies the player received the third star for a game when `1`
`giveaways`	`player` - `statistics`	Integer	Number of giveaways
`goals`	`player` - `statistics`	Integer	Number of goals
`hits`	`player` - `statistics`	Integer	Number of hits
`missed_shots`	`player` - `statistics`	Integer	Number of missed_shots
`overtime_assists`	`player` - `statistics`	Integer	Number of overtime assists
`overtime_goals`	`player` - `statistics`	Integer	Number of overtime goals
`overtime_shots`	`player` - `statistics`	Integer	Number of overtime shots
`overtime`	`player` - `time_on_ice`	String	Overtime time on ice in seconds ex. `00:13`
`penalties`	`player` - `statistics`	Integer	Number of penalties
`penalties_major`	`player` - `statistics`	Integer	Number of major penalties
`penalties_match`	`player` - `statistics`	Integer	Number of match penalties
`penalties_minor`	`player` - `statistics`	Integer	Number of minor penalties
`penalties_misconduct`	`player` - `statistics`	Integer	Number of misconduct penalties
`penalty_minutes_additional`	`player` - `statistics`	Integer	Number of additional penalty minutes (penalty minutes that go beyond standard minor, major, or misconduct penalties)
`goals`	`player` - `statistics` - `penalty`	Integer	Number of penalty goals
`missed_shots`	`player` - `statistics` - `penalty`	Integer	Number of penalty missed shots
`shots`	`player` - `statistics` - `penalty`	Integer	Number of penalty shots on goal
`penalty_minutes`	`player` - `statistics`	Integer	Number of penalty minutes
`plus_minus`	`player` - `statistics`	Integer	Plus/Minus (Team scoring while a player is on the rink) ex. `-1` or `2`
`points`	`player` - `statistics`	Integer	Number of points
`assists`	`player` - `statistics` - `powerplay`	Integer	Number of power play assists
`faceoff_win_pct`	`player` - `statistics` - `powerplay`	Decimal	Power play faceoff win percentage
`faceoffs`	`player` - `statistics` - `powerplay`	Integer	Number of power play faceoffs
`faceoffs_lost`	`player` - `statistics` - `powerplay`	Integer	Number of power play faceoffs lost
`faceoffs_won`	`player` - `statistics` - `powerplay`	Integer	Number of power play faceoffs won
`goals`	`player` - `statistics` - `powerplay`	Integer	Number of power play goals
`missed_shots`	`player` - `statistics` - `powerplay`	Integer	Number of power play missed shots
`shots`	`player` - `statistics` - `powerplay`	Integer	Number of power play shots on goal
`powerplay`	`player` - `time_on_ice`	String	Power play time on ice in seconds ex. `1:31`
`shifts`	`player` - `time_on_ice`	Integer	Number of shifts
`shooting_pct`	`player` - `statistics`	Decimal	Shooting percentage ex. `80.0`
`goals`	`player` - `statistics` - `shootout`	Integer	Number of shootout goals
`missed_shots`	`player` - `statistics` - `shootout`	Integer	Number of shootout missed shots
`shots`	`player` - `statistics` - `shootout`	Integer	Number of shootout shots on goal
`assists`	`player` - `statistics` - `shorthanded`	Integer	Number of power play assists
`faceoff_win_pct`	`player` - `statistics` - `shorthanded`	Decimal	Short handed faceoff win percentage
`faceoffs`	`player` - `statistics` - `shorthanded`	Integer	Number of short handed faceoffs
`faceoffs_lost`	`player` - `statistics` - `shorthanded`	Integer	Number of short handed faceoffs lost
`faceoffs_won`	`player` - `statistics` - `shorthanded`	Integer	Number of short handed faceoffs won
`goals`	`player` - `statistics` - `shorthanded`	Integer	Number of power short handed
`missed_shots`	`player` - `statistics` - `shorthanded`	Integer	Number of short handed missed shots
`shots`	`player` - `statistics` - `shorthanded`	Integer	Number of short handed shots on goal
`shorthanded`	`player` - `time_on_ice`	String	Short handed time on ice in seconds ex. `00:32`
`shots`	`player` - `statistics`	Integer	Number of shots on goal
`takeaways`	`player` - `statistics`	Integer	Number of takeaways
`total`	`player` - `time_on_ice`	String	Total time on ice in seconds ex. `19:13`

Period Statistics (Player)

Attribute	Parent Element	Type	Description
`assists`	`player` - `statistics` - `period`	Integer	Number of assists
`blocked_att`	`player` - `statistics` - `period`	Integer	Number of blocked attempts (i.e. player's shot was blocked)
`blocked_shots`	`player` - `statistics` - `period`	Integer	Number of blocked shots (i.e. player blocked a shot)
`assists`	`player` - `statistics` - `period` - `evenstrength`	Integer	Number of even strength assists
`goals`	`player` - `statistics` - `period` - `evenstrength`	Integer	Number of even strength goals
`missed_shots`	`player` - `statistics` - `period` - `evenstrength`	Integer	Number of even strength missed shots
`shots`	`player` - `statistics` - `period` - `evenstrength`	Integer	Number of even strength shots on goal
`faceoff_win_pct`	`player` - `statistics` - `period`	Decimal	Faceoff win percentage ex. `46.7`
`faceoffs`	`player` - `statistics` - `period`	Integer	Number of faceoffs
`faceoffs_lost`	`player` - `statistics` - `period`	Integer	Number of faceoffs lost
`faceoffs_won`	`player` - `statistics` - `period`	Integer	Number of faceoffs won
`giveaways`	`player` - `statistics` - `period`	Integer	Number of giveaways
`goals`	`player` - `statistics` - `period`	Integer	Number of goals
`hits`	`player` - `statistics` - `period`	Integer	Number of hits
`missed_shots`	`player` - `statistics` - `period`	Integer	Number of missed_shots
`penalties`	`player` - `statistics` - `period`	Integer	Number of penalties
`goals`	`player` - `statistics` - `period` - `penalty`	Integer	Number of penalty goals
`missed_shots`	`player` - `statistics` - `period` - `penalty`	Integer	Number of penalty missed shots
`shots`	`player` - `statistics` - `period` - `penalty`	Integer	Number of penalty shots on goal
`penalty_minutes`	`player` - `statistics` - `period`	Integer	Number of penalty minutes
`points`	`player` - `statistics` - `period`	Integer	Number of points
`assists`	`player` - `statistics` - `period` - `powerplay`	Integer	Number of power play assists
`goals`	`player` - `statistics` - `period` - `powerplay`	Integer	Number of power play goals
`missed_shots`	`player` - `statistics` - `period` - `powerplay`	Integer	Number of power play missed shots
`shots`	`player` - `statistics` - `period` - `powerplay`	Integer	Number of power play shots on goal
`shifts`	`player` - `time_on_ice`	Integer	Number of shifts
`shooting_pct`	`player` - `statistics` - `period`	Decimal	Shooting percentage ex. `80.0`
`assists`	`player` - `statistics` - `period` - `shorthanded`	Integer	Number of power play assists
`goals`	`player` - `statistics` - `period` - `shorthanded`	Integer	Number of power short handed
`missed_shots`	`player` - `statistics` - `period` - `shorthanded`	Integer	Number of short handed missed shots
`shots`	`player` - `statistics` - `period` - `shorthanded`	Integer	Number of short handed shots on goal
`shots`	`player` - `statistics` - `period`	Integer	Number of shots on goal
`takeaways`	`player` - `statistics` - `period`	Integer	Number of takeaways

Player

Attribute	Parent Element	Type	Description
`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`
`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`

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

Stars of the Game

Attribute	Parent Element	Type	Description
`sequence`	`stars` - `star`	Integer	Star number `1`, `2`, `3`
`full_name`	`stars` - `player`	String	Full name of a player ex. `Sidney Crosby`
`id`	`stars` - `player`	GUID	Unique ID of a player ex. `433de553-0f24-11e2-8525-18a905767e44`
`jersey_number`	`stars` - `player`	Integer	Number of a player's jersey
`position`	`stars` - `player`	String	Position of a player `NA`, `D`, `F`, `F-D`, `G`
`reference`	`stars` - `player`	String	League reference ID of a player ex. `8471675`
`sr_id`	`stars` - `player`	GUID	Unique Sportradar ID of a player ex. `sr:player:31007`
`id`	`stars` - `team`	GUID	Unique ID of a team ex. `bdc11650-6f74-49c4-875e-778aeb7632d9`
`market`	`stars` - `team`	String	Market name of a team ex. `Minnesota`
`name`	`stars` - `team`	String	Team name ex. `Wild`
`reference`	`stars` - `team`	String	League reference ID of a team ex. `30`
`sr_id`	`stars` - `team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3689`

200200