Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Player Profile

NHL Player Profile provides player biographical information, draft information, and seasonal statistics.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 4 hours

Data Updates: Stats update around 5 minutes after a game is moved to closed


Data Points

League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. NHL
idleagueGUIDUnique ID of a league

ex. fd560107-a85b-4388-ab0d-655ad022aff7
nameleagueStringName of a league

ex. NHL
idseasonGUIDUnique ID of a season

ex. 5d08ca09-ec49-4559-9c0f-257c0158e57f
typeseasonStringType of season

REG (Regular Season), PST (Postseason)
yearseasonIntegerYear of a season

2022 = 2022-23 Season
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. S.Crosby
birthdateplayerDatePlayer date of birth

ex. 1987-08-07
birth_placeplayerStringBirthplace of a player

ex. Cole Harbour, NS, CAN
collegeplayerStringCollege attended

ex. Michigan
experienceplayerunsignedByteNumber of years played in the NHL
first_nameplayerStringFirst name of a player

ex. Sidney
full_nameplayerStringFull name of a player

ex. Sidney Crosby
handednessplayerStringDominant hand of a player

ex. L, R
heightplayerunsignedByteHeight in inches
high_schoolplayerStringHigh school attended
idplayerGUIDUnique ID of a player

ex. 433de553-0f24-11e2-8525-18a905767e44
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player

ex. Crosby
name_suffixplayerStringSuffix of a player

ex. Jr.
nationalityplayerStringCountry the player represents internationally, which may differ from birth_place

ex. CAN
positionplayerStringPosition of a player

NA, D, F, F-D, G
primary_positionplayerStringPrimary position of a player

NA, C, D, G, LW, RW
referenceplayerStringLeague reference ID of a player

ex. 8471675
rookie_yearplayerIntegerRookie year in the NHL
salaryplayerIntegerCurrent base annual salary of a player

ex. 8700000
sr_idplayerGUIDUnique Sportradar ID of a player

ex. sr:player:31007
statusplayerStringStatus 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)
updatedplayerdateTimeTimestamp of a change to a free agent status

ex. 2026-04-17T02:30:00+00:00
weightplayerunsignedShortWeight in lbs.
Player Reference

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

AttributeParent ElementTypeDescription
id_typeplayer - referenceStringType 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)
scopeplayer - referenceStringName 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_idplayer - referenceGUIDUnique 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
AttributeParent ElementTypeDescription
pickdraftIntegerDraft pick number of a player
rounddraftIntegerDraft pick round of a player
team_iddraftIntegerUnique ID of a draft team

ex. 4417b7d7-0f24-11e2-8525-18a905767e44
yeardraftIntegerDraft year of a player
Season Statistics (Skater) - Totals
AttributeParent ElementTypeDescription
assistsseason - team - statistics - totalIntegerNumber of assists
blocked_attseason - team - statistics - totalIntegerNumber of blocked attempts (i.e. player's shot was blocked)
blocked_shotsseason - team - statistics - totalIntegerNumber of blocked shots (i.e. player blocked a shot)
emptynet_goalsseason - team - statistics - totalIntegerNumber of empty net goals
faceoff_win_pctseason - team - statistics - totalDecimalFaceoff win percentage

ex. 46.7
faceoffsseason - team - statistics - totalIntegerNumber of faceoffs
faceoffs_lostseason - team - statistics - totalIntegerNumber of faceoffs lost
faceoffs_wonseason - team - statistics - totalIntegerNumber of faceoffs won
games_playedseason - team - statistics - totalIntegerNumber of games played
games_scratchedseason - team - statistics - totalIntegerNumber of games scratched
games_startedseason - team - statistics - totalIntegerNumber of games started
giveawaysseason - team - statistics - totalIntegerNumber of giveaways
goalsseason - team - statistics - totalIntegerNumber of goals
hitsseason - team - statistics - totalIntegerNumber of hits
missed_shotsseason - team - statistics - totalIntegerNumber of missed shots
overtime_assistsseason - team - statistics - totalIntegerNumber of overtime assists
overtime_goalsseason - team - statistics - totalIntegerNumber of overtime goals
overtime_shotsseason - team - statistics - totalIntegerNumber of overtime shots
penaltiesseason - team - statistics - totalIntegerNumber of penalties
penalties_majorseason - team - statistics - totalIntegerNumber of major penalties
penalties_matchseason - team - statistics - totalIntegerNumber of match penalties
penalties_minorseason - team - statistics - totalIntegerNumber of minor penalties
penalties_misconductseason - team - statistics - totalIntegerNumber of misconduct penalties
penalty_minutesseason - team - statistics - totalIntegerNumber of penalty minutes
penalty_minutes_additionalseason - team - statistics - totalIntegerNumber of additional penalty minutes (penalty minutes that go beyond standard minor, major, or misconduct penalties)
plus_minusseason - team - statistics - totalIntegerPlus/Minus (Team scoring while a player is on the ice)

ex. -1 or 2
pointsseason - team - statistics - totalIntegerNumber of points
shooting_pctseason - team - statistics - totalDecimalShooting percentage

ex. 80.0
shotsseason - team - statistics - totalIntegerNumber of shots on goal
takeawaysseason - team - statistics - totalIntegerNumber of takeaways
winning_goalseason - team - statistics - totalIntegerNumber of game winning goals
first_starseason - team - statistics - totalIntegerNumber of first stars
second_starseason - team - statistics - totalIntegerNumber of second stars
third_starseason - team - statistics - totalIntegerNumber of third stars
tying_goalsseason - team - statistics - totalIntegerNumber of tying goals

A tying goal is defined as a final goal which ties a game, prior to the game proceeding to overtime
assistsseason - team - statistics - total - evenstrengthIntegerNumber of even strength assists
faceoff_win_pctseason - team - statistics - total - evenstrengthDecimalEven strength faceoff win percentage
faceoffsseason - team - statistics - total - evenstrengthIntegerNumber of even strength faceoffs
faceoffs_lostseason - team - statistics - total - evenstrengthIntegerNumber of even strength faceoffs lost
faceoffs_wonseason - team - statistics - total - evenstrengthIntegerNumber of even strength faceoffs won
goalsseason - team - statistics - total - evenstrengthIntegerNumber of even strength goals
missed_shotsseason - team - statistics - total - evenstrengthIntegerNumber of even strength missed shots
shotsseason - team - statistics - total - evenstrengthIntegerNumber of even strength shots on goal
assistsseason - team - statistics - total - powerplayIntegerNumber of power play assists
faceoff_win_pctseason - team - statistics - total - powerplayDecimalPower play faceoff win percentage
faceoffsseason - team - statistics - total - powerplayIntegerNumber of power play faceoffs
faceoffs_lostseason - team - statistics - total - powerplayIntegerNumber of power play faceoffs lost
faceoffs_wonseason - team - statistics - total - powerplayIntegerNumber of power play faceoffs won
goalsseason - team - statistics - total - powerplayIntegerNumber of power play goals
missed_shotsseason - team - statistics - total - powerplayIntegerNumber of power play missed shots
pointsseason - team - statistics - total - powerplayIntegerNumber of power play points
shotsseason - team - statistics - total - powerplayIntegerNumber of power play shots on goal
assistsseason - team - statistics - total - shorthandedIntegerNumber of short-handed assists
faceoff_win_pctseason - team - statistics - total - shorthandedDecimalShort-handed faceoff win percentage
faceoffsseason - team - statistics - total - shorthandedIntegerNumber of short-handed faceoffs
faceoffs_lostseason - team - statistics - total - shorthandedIntegerNumber of short-handed faceoffs lost
faceoffs_wonseason - team - statistics - total - shorthandedIntegerNumber of short-handed faceoffs won
goalsseason - team - statistics - total - shorthandedIntegerNumber of short-handed goals
missed_shotsseason - team - statistics - total - shorthandedIntegerNumber of short-handed missed shots
pointsseason - team - statistics - total - shorthandedIntegerNumber of short-handed points
shotsseason - team - statistics - total - shorthandedIntegerNumber of short-handed shots on goal
goalsseason - team - statistics - total - penaltyIntegerNumber of penalty goals
missed_shotsseason - team - statistics - total - penaltyIntegerNumber of penalty missed shots
shotsseason - team - statistics - total - penaltyIntegerNumber of penalty shots on goal
goalsseason - team - statistics - total - shootoutIntegerNumber of shootout goals
missed_shotsseason - team - statistics - total - shootoutIntegerNumber of shootout missed shots
shotsseason - team - statistics - total - shootoutIntegerNumber of shootout shots on goal
shiftsteam - time_on_ice - totalIntegerNumber of shifts
totalteam - time_on_ice - totalStringTotal time on ice in seconds

ex. 528:32
overtimeteam - time_on_ice - totalStringTotal overtime time on ice in seconds

ex. 8:15
evenstrengthteam - time_on_ice - totalStringTotal even strength time on ice in seconds

ex. 417:15
powerplayteam - time_on_ice - totalStringTotal power play time on ice in seconds

ex. 88:15
shorthandedteam - time_on_ice - totalStringTotal short-handed time on ice in seconds

ex. 8:15
Season Statistics (Skater) - Averages
AttributeParent ElementTypeDescription
assistsseason - team - statistics - averageDecimalAssists per game
blocked_attseason - team - statistics - averageDecimalBlocked attempts per game (i.e. player's shot was blocked)
blocked_shotsseason - team - statistics - averageDecimalBlocked shots per game (i.e. player blocked a shot)
giveawaysseason - team - statistics - averageDecimalGiveaways per game
goalsseason - team - statistics - averageDecimalGoals per game
hitsseason - team - statistics - averageDecimalHits per game
missed_shotsseason - team - statistics - averageDecimalMissed shots per game
penaltiesseason - team - statistics - averageDecimalPenalties per game
penalty_minutesseason - team - statistics - averageDecimalPenalty minutes per game
pointsseason - team - statistics - averageDecimalPoints per game
shotsseason - team - statistics - averageDecimalShots on goal per game
takeawaysseason - team - statistics - averageDecimalTakeaways per game
shiftsteam - time_on_ice - averageDecimalShifts per game
totalteam - time_on_ice - averageStringTime on ice per game

ex. 18:14
overtimeteam - time_on_ice - averageStringOvertime time on ice per game

ex. 1:39
evenstrengthteam - time_on_ice - averageStringEven strength time on ice per game

ex. 16:39
powerplayteam - time_on_ice - averageStringPower play time on ice per game

ex. 1:39
shorthandedteam - time_on_ice - averageStringShort-handed time on ice per game

ex. 1:39
Goalies Season Statistics - (Player)
AttributeParent ElementTypeDescription
avg_goals_againstteam - goaltending - averageDecimalGoals against per game
games_playedteam - goaltending - totalIntegerNumber of games played
goals_againstteam - goaltending - totalIntegerNumber of goals against
goals_againstteam - goaltending - averageDecimalGoals against per game
lossesteam - goaltending - totalIntegerNumber of losses
overtime_lossesteam - goaltending - totalIntegerNumber of overtime losses
saves_pctteam - goaltending - totalDecimalSave percentage
savesteam - goaltending - totalIntegerNumber of saves
shots_againstteam - goaltending - totalIntegerNumber of shots against
shots_againstteam - goaltending - averageDecimalShots against per game
shutoutsteam - goaltending - totalIntegerNumber of shutouts
winsteam - goaltending - totalIntegerNumber of wins
goals_againstteam - goaltending - total - evenstrengthIntegerNumber of even strength goals against
shots_againstteam - goaltending - total - evenstrengthIntegerNumber of even strength shots against
saves_pctteam - goaltending - total - evenstrengthDecimalEven strength save percentage
savesteam - goaltending - total - evenstrengthIntegerNumber of even strength saves
goals_againstteam - goaltending - total - penaltyIntegerNumber of penalty goals against
shots_againstteam - goaltending - total - penaltyIntegerNumber of penalty shots against
saves_pctteam - goaltending - total - penaltyDecimalPenalty shot save percentage
savesteam - goaltending - total - penaltyIntegerNumber of penalty shot saves
goals_againstteam - goaltending - total - powerplayIntegerNumber of power play goals against
shots_againstteam - goaltending - total - powerplayIntegerNumber of power play shots against
saves_pctteam - goaltending - total - powerplayDecimalPower play save percentage
savesteam - goaltending - total - powerplayIntegerNumber of power play saves
goals_againstteam - goaltending - total - shootoutIntegerNumber of shootout goals against
shots_againstteam - goaltending - total - shootoutIntegerNumber of shootout shots against
saves_pctteam - goaltending - total - shootoutDecimalShootout save percentage
savesteam - goaltending - total - shootoutIntegerNumber of shootout saves
goals_againstteam - goaltending - total - shorthandedIntegerNumber of short-handed goals against
shots_againstteam - goaltending - total - shorthandedIntegerNumber of short-handed shots against
saves_pctteam - goaltending - total - shorthandedDecimalShort-handed save percentage
savesteam - goaltending - total - shorthandedIntegerNumber of short-handed saves
Team
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team

ex. MIN (Minnesota)
idteamGUIDUnique ID of a team

ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team

ex. Minnesota
nameteamStringTeam name

ex. Wild
referenceteamStringLeague reference ID of a team

ex. 30
sr_idteamGUIDUnique Sportradar ID of a team

ex. sr:team:3689

Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

br (Brazilian Portuguese), en (English), es (Spanish), fr (French), ru (Russian), zh (Simplified Chinese)

Allowed:
string
required
Defaults to 42a966db-0f24-11e2-8525-18a905767e44

Unique Id of a player

Example: 42a966db-0f24-11e2-8525-18a905767e44

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json