⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Stats update around 5 minutes after a game is moved to closed

Data Points

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NHL`
`id`	`league`	GUID	Unique ID of a league ex. `fd560107-a85b-4388-ab0d-655ad022aff7`
`name`	`league`	String	Name of a league ex. `NHL`
`id`	`season`	GUID	Unique ID of a season ex. `5d08ca09-ec49-4559-9c0f-257c0158e57f`
`type`	`season`	String	Type of season `REG` (Regular Season), `PST` Postseason)
`year`	`season`	Integer	Year of a season `2022` = 2022-23 Season

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `S.Crosby`
`birthdate`	`player`	Date	Player date of birth ex. `1987-08-07`
`birth_place`	`player`	String	Birthplace of a player ex. `Cole Harbour, NS, CAN`
`college`	`player`	String	College attended ex. `Michigan`
`experience`	`player`	unsignedByte	Number of years played in the NHL
`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`
`height`	`player`	unsignedByte	Height in inches
`high_school`	`player`	String	High school attended
`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`
`rookie_year`	`player`	Integer	Rookie year in the NHL
`salary`	`player`	Integer	Current base annual salary of a player ex. `8700000`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:31007`
`status`	`player`	String	Status of a player `ACT` (Active), `DUP` (Duplicate), `FA` (Free Agent), `IR` (Injured reserve), `M-LEAGUE` (Sent to minor league team), `NWT` (Not with team), `RET` (Retired), `SUS` (Suspended), `UDP` (Unsigned Draft Pick)
`updated`	`player`	dateTime	Timestamp of a change to a free agent status ex. `2026-04-17T02:30:00+00:00`
`weight`	`player`	unsignedShort	Weight in lbs.

Player Reference

Use the reference field to link a player's NHL API profile to their NCAA Men's Hockey API profile

Attribute	Parent Element	Type	Description
`id_type`	`player` - `reference`	String	Type of a player's linked player Id ex. `league_profile` (League Player Id), `external` (NHL official `reference` Id), `sport_profile` (League-Specific API Id, synched across NHL and NCAAMH APIs)
`scope`	`player` - `reference`	String	Name of the league/API for a player's linked Id ex. `NCAAMH` (NCAA Men's Hockey API), `NHL` (NHL official `reference` Id), `hockey` (Player "parent" Id entry for League-Specific Sport APIs)
`source_id`	`player` - `reference`	GUID	Unique player Id for a linked player profile ex. `423a6f6b-12b3-4698-8b37-7288430cc0d2` (Player Id within the NCAA Men's Hockey API), `8480068` (NHL official `reference` Id)

Draft

Attribute	Parent Element	Type	Description
`pick`	`draft`	Integer	Draft pick number of a player
`round`	`draft`	Integer	Draft pick round of a player
`team_id`	`draft`	Integer	Unique ID of a draft team ex. `4417b7d7-0f24-11e2-8525-18a905767e44`
`year`	`draft`	Integer	Draft year of a player

Season Statistics (Skater) - Totals

Attribute	Parent Element	Type	Description
`assists`	`season` - `team` - `statistics` - `total`	Integer	Number of assists
`blocked_att`	`season` - `team` - `statistics` - `total`	Integer	Number of blocked attempts (i.e. player's shot was blocked)
`blocked_shots`	`season` - `team` - `statistics` - `total`	Integer	Number of blocked shots (i.e. player blocked a shot)
`emptynet_goals`	`season` - `team` - `statistics` - `total`	Integer	Number of empty net goals
`faceoff_win_pct`	`season` - `team` - `statistics` - `total`	Decimal	Faceoff win percentage ex. `46.7`
`faceoffs`	`season` - `team` - `statistics` - `total`	Integer	Number of faceoffs
`faceoffs_lost`	`season` - `team` - `statistics` - `total`	Integer	Number of faceoffs lost
`faceoffs_won`	`season` - `team` - `statistics` - `total`	Integer	Number of faceoffs won
`games_played`	`season` - `team` - `statistics` - `total`	Integer	Number of games played
`games_scratched`	`season` - `team` - `statistics` - `total`	Integer	Number of games scratched
`games_started`	`season` - `team` - `statistics` - `total`	Integer	Number of games started
`giveaways`	`season` - `team` - `statistics` - `total`	Integer	Number of giveaways
`goals`	`season` - `team` - `statistics` - `total`	Integer	Number of goals
`hits`	`season` - `team` - `statistics` - `total`	Integer	Number of hits
`missed_shots`	`season` - `team` - `statistics` - `total`	Integer	Number of missed shots
`overtime_assists`	`season` - `team` - `statistics` - `total`	Integer	Number of overtime assists
`overtime_goals`	`season` - `team` - `statistics` - `total`	Integer	Number of overtime goals
`overtime_shots`	`season` - `team` - `statistics` - `total`	Integer	Number of overtime shots
`penalties`	`season` - `team` - `statistics` - `total`	Integer	Number of penalties
`penalties_major`	`season` - `team` - `statistics` - `total`	Integer	Number of major penalties
`penalties_match`	`season` - `team` - `statistics` - `total`	Integer	Number of match penalties
`penalties_minor`	`season` - `team` - `statistics` - `total`	Integer	Number of minor penalties
`penalties_misconduct`	`season` - `team` - `statistics` - `total`	Integer	Number of misconduct penalties
`penalty_minutes`	`season` - `team` - `statistics` - `total`	Integer	Number of penalty minutes
`penalty_minutes_additional`	`season` - `team` - `statistics` - `total`	Integer	Number of additional penalty minutes (penalty minutes that go beyond standard minor, major, or misconduct penalties)
`plus_minus`	`season` - `team` - `statistics` - `total`	Integer	Plus/Minus (Team scoring while a player is on the rink) ex. `-1` or `2`
`points`	`season` - `team` - `statistics` - `total`	Integer	Number of points
`shooting_pct`	`season` - `team` - `statistics` - `total`	Decimal	Shooting percentage ex. `80.0`
`shots`	`season` - `team` - `statistics` - `total`	Integer	Number of shots on goal
`takeaways`	`season` - `team` - `statistics` - `total`	Integer	Number of takeaways
`winning_goal`	`season` - `team` - `statistics` - `total`	Integer	Number of game winning goals
`first_star`	`season` - `team` - `statistics` - `total`	Integer	Number of first stars
`second_star`	`season` - `team` - `statistics` - `total`	Integer	Number of second stars
`third_star`	`season` - `team` - `statistics` - `total`	Integer	Number of third stars
`tying_goals`	`season` - `team` - `statistics` - `total`	Integer	Number of tying goals A tying goal is defined as a final goal which ties a game, prior to the game proceeding to overtime
`assists`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength assists
`faceoff_win_pct`	`season` - `team` - `statistics` - `total` - `evenstrength`	Decimal	Even strength faceoff win percentage
`faceoffs`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength faceoffs
`faceoffs_lost`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength faceoffs lost
`faceoffs_won`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength faceoffs won
`goals`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength goals
`missed_shots`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength missed shots
`shots`	`season` - `team` - `statistics` - `total` - `evenstrength`	Integer	Number of even strength shots on goal
`assists`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play assists
`faceoff_win_pct`	`season` - `team` - `statistics` - `total` - `powerplay`	Decimal	Power play faceoff win percentage
`faceoffs`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play faceoffs
`faceoffs_lost`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play faceoffs lost
`faceoffs_won`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play faceoffs won
`goals`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play goals
`missed_shots`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play missed shots
`points`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play points
`shots`	`season` - `team` - `statistics` - `total` - `powerplay`	Integer	Number of power play shots on goal
`assists`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed assists
`faceoff_win_pct`	`season` - `team` - `statistics` - `total` - `shorthanded`	Decimal	Short-handed faceoff win percentage
`faceoffs`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed faceoffs
`faceoffs_lost`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed faceoffs lost
`faceoffs_won`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed faceoffs won
`goals`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed goals
`missed_shots`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed missed shots
`points`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed points
`shots`	`season` - `team` - `statistics` - `total` - `shorthanded`	Integer	Number of short-handed shots on goal
`goals`	`season` - `team` - `statistics` - `total` - `penalty`	Integer	Number of penalty goals
`missed_shots`	`season` - `team` - `statistics` - `total` - `penalty`	Integer	Number of penalty missed shots
`shots`	`season` - `team` - `statistics` - `total` - `penalty`	Integer	Number of penalty shots on goal
`goals`	`season` - `team` - `statistics` - `total` - `shootout`	Integer	Number of shootout goals
`missed_shots`	`season` - `team` - `statistics` - `total` - `shootout`	Integer	Number of shootout missed shots
`shots`	`season` - `team` - `statistics` - `total` - `shootout`	Integer	Number of shootout shots on goal
`shifts`	`team` - `time_on_ice` - `total`	Integer	Number of shifts
`total`	`team` - `time_on_ice` - `total`	String	Total time on ice in seconds ex. `528:32`
`overtime`	`team` - `time_on_ice` - `total`	String	Total overtime time on ice in seconds ex. `8:15`
`evenstrength`	`team` - `time_on_ice` - `total`	String	Total even strength time on ice in seconds ex. `417:15`
`powerplay`	`team` - `time_on_ice` - `total`	String	Total power play time on ice in seconds ex. `88:15`
`shorthanded`	`team` - `time_on_ice` - `total`	String	Total short-handed time on ice in seconds ex. `8:15`

Season Statistics (Skater) - Averages

Attribute	Parent Element	Type	Description
`assists`	`season` - `team` - `statistics` - `average`	Decimal	Assists per game
`blocked_att`	`season` - `team` - `statistics` - `average`	Decimal	Blocked attempts per game (i.e. player's shot was blocked)
`blocked_shots`	`season` - `team` - `statistics` - `average`	Decimal	Blocked shots per game (i.e. player blocked a shot)
`giveaways`	`season` - `team` - `statistics` - `average`	Decimal	Giveaways per game
`goals`	`season` - `team` - `statistics` - `average`	Decimal	Goals per game
`hits`	`season` - `team` - `statistics` - `average`	Decimal	Hits per game
`missed_shots`	`season` - `team` - `statistics` - `average`	Decimal	Missed shots per game
`penalties`	`season` - `team` - `statistics` - `average`	Decimal	Penalties per game
`penalty_minutes`	`season` - `team` - `statistics` - `average`	Decimal	Penalty minutes per game
`points`	`season` - `team` - `statistics` - `average`	Decimal	Points per game
`shots`	`season` - `team` - `statistics` - `average`	Decimal	Shots on goal per game
`takeaways`	`season` - `team` - `statistics` - `average`	Decimal	Takeaways per game
`shifts`	`team` - `time_on_ice` - `average`	Decimal	Shifts per game
`total`	`team` - `time_on_ice` - `average`	String	Time on ice per game ex. `18:14`
`overtime`	`team` - `time_on_ice` - `average`	String	Overtime time on ice per game ex. `1:39`
`evenstrength`	`team` - `time_on_ice` - `average`	String	Even strength time on ice per game ex. `16:39`
`powerplay`	`team` - `time_on_ice` - `average`	String	Power play time on ice per game ex. `1:39`
`shorthanded`	`team` - `time_on_ice` - `average`	String	Short-handed time on ice per game ex. `1:39`

Goalies Season Statistics - (Player)

Attribute	Parent Element	Type	Description
`avg_goals_against`	`team` - `goaltending` - `average`	Decimal	Goals against per game
`games_played`	`team` - `goaltending` - `total`	Integer	Number of games played
`goals_against`	`team` - `goaltending` - `total`	Integer	Number of goals against
`goals_against`	`team` - `goaltending` - `average`	Decimal	Goals against per game
`losses`	`team` - `goaltending` - `total`	Integer	Number of losses
`overtime_losses`	`team` - `goaltending` - `total`	Integer	Number of overtime losses
`saves_pct`	`team` - `goaltending` - `total`	Decimal	Save percentage
`saves`	`team` - `goaltending` - `total`	Integer	Number of saves
`shots_against`	`team` - `goaltending` - `total`	Integer	Number of shots against
`shots_against`	`team` - `goaltending` - `average`	Decimal	Shots against per game
`shutouts`	`team` - `goaltending` - `total`	Integer	Number of shutouts
`wins`	`team` - `goaltending` - `total`	Integer	Number of wins
`goals_against`	`team` - `goaltending` - `total` - `evenstrength`	Integer	Number of even strength goals against
`shots_against`	`team` - `goaltending` - `total` - `evenstrength`	Integer	Number of even strength shots against
`saves_pct`	`team` - `goaltending` - `total` - `evenstrength`	Decimal	Even strength save percentage
`saves`	`team` - `goaltending` - `total` - `evenstrength`	Integer	Number of even strength saves
`goals_against`	`team` - `goaltending` - `total` - `penalty`	Integer	Number of penalty goals against
`shots_against`	`team` - `goaltending` - `total` - `penalty`	Integer	Number of penalty shots against
`saves_pct`	`team` - `goaltending` - `total` - `penalty`	Decimal	Penalty shot save percentage
`saves`	`team` - `goaltending` - `total` - `penalty`	Integer	Number of penalty shot saves
`goals_against`	`team` - `goaltending` - `total` - `powerplay`	Integer	Number of power play goals against
`shots_against`	`team` - `goaltending` - `total` - `powerplay`	Integer	Number of power play shots against
`saves_pct`	`team` - `goaltending` - `total` - `powerplay`	Decimal	Power play save percentage
`saves`	`team` - `goaltending` - `total` - `powerplay`	Integer	Number of power play saves
`goals_against`	`team` - `goaltending` - `total` - `shootout`	Integer	Number of shootout goals against
`shots_against`	`team` - `goaltending` - `total` - `shootout`	Integer	Number of shootout shots against
`saves_pct`	`team` - `goaltending` - `total` - `shootout`	Decimal	Shootout save percentage
`saves`	`team` - `goaltending` - `total` - `shootout`	Integer	Number of shootout shot saves
`goals_against`	`team` - `goaltending` - `total` - `shorthanded`	Integer	Number of short-handed goals against
`shots_against`	`team` - `goaltending` - `total` - `shorthanded`	Integer	Number of short-handed shots against
`saves_pct`	`team` - `goaltending` - `total` - `shorthanded`	Decimal	Short-handed save percentage
`saves`	`team` - `goaltending` - `total` - `shorthanded`	Integer	Number of short-handed saves

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `MIN` (Minnesota)
`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`

200200