Player Profile

Time	Status	User Agent
Retrieving recent requests…

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

📘
Building Player Views
Learn how to use the Player Profile for player bios and career statistics in our Roster and Player Details integration scenario.

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.`
`nationality`	`player`	String	Country the player represents internationally, which may differ from `birth_place` ex. `CAN`
`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 ice) 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 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`

Update Frequency

Building Player Views

Data Points

200200