get
https://api.sportradar.com/nhl//v7//teams//profile.
NHL Team Profile provides top-level team information and a full roster of active players.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 4 hours
Data Updates: Updates in realtime as changes are made to rosters or player profiles
Managing RostersLearn how to use the Team Profile for team details and current roster context 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 |
alias | conference | String | Alias of a conference ex. WESTERN |
id | conference | GUID | Unique ID of a conference ex. 64901512-9ca9-4bea-aa80-16dbcbdae230 |
name | conference | String | Name of a conference ex. WESTERN CONFERENCE |
alias | division | String | Alias of a division ex. CENTRAL |
id | division | GUID | Unique ID of a division ex. 5e868c4d-c6a3-4901-bc3c-3b7a4509e402 |
name | division | String | Name of a division ex. Central |
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 |
captain | player | Boolean | Type of team captainC(Team Captain), A(Alternate Captain), N(Not a captain) |
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_placeex. CAN |
position | player | String | Position of a playerNA, D, F, F-D, G |
primary_position | player | String | Primary position of a playerNA, 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 playerACT (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
referencefield 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 | player - draft | Integer | Draft pick number of a player |
round | player - draft | Integer | Draft pick round of a player |
team_id | player - draft | Integer | Unique ID of a draft team ex. 4417b7d7-0f24-11e2-8525-18a905767e44 |
year | player - draft | Integer | Draft year of a player |
Player Injuries
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
comment | players - injuries - 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 | players - injuries - injury | String | Brief description of an injury ex. Lower-Body |
id | players - injuries - injury | GUID | Unique ID of an injury ex. 68a440e4-6ce3-48d7-a299-52412e10c7b7 |
start_date | players - injuries - injury | Date | Date an injury transaction goes into effect ex. 2022-12-02 |
status | players - injuries - injury | String | Status of an injuryUnknown, Day To Day, Out, Out for Season, Out Indefinitely |
update_date | players - injuries - injury | Date | Date of an injury update ex. 2022-12-03 |
Team
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | team | String | Abbreviation of a team ex. MIN (Minnesota) |
championship_seasons | team | String | Years of championship seasons ex. 1991, 1992, 1993, 1996, 1997, 1998 |
championships_won | team | Integer | Number of championships won |
conference_titles | team | Integer | Number of conference titles |
division_titles | team | Integer | Number of division titles |
founded | team | Integer | Year team was founded ex. 2000 |
general_manager | team | String | Team general manager ex. Bill Guerin |
id | team | GUID | Unique ID of a team ex. bdc11650-6f74-49c4-875e-778aeb7632d9 |
market | team | String | Market name of a team ex. Minnesota |
mascot | team | String | Team mascot ex. Nordy |
minorleague_affiliate | team | String | A team's minor league affiliate(s) ex. Iowa Wild, Iowa Heartlanders |
name | team | String | Team name ex. Wild |
nicknames | team | String | Team nicknames ex. Canes |
owner | team | String | Team owner ex. Craig Leipold |
playoff_appearances | team | Integer | Number of playoff appearances |
president | team | String | Team president ex. Bill Guerin |
presidents_trophies | team | Integer | Number of Presidents' Trophies |
reference | team | String | League reference ID of a team ex. 30 |
sponsor | team | String | Team sponsor ex. TRIA Orthopedics |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3689 |
hex_color | team_color | String | Team color HEX value ex. #024930 |
type | team_color | String | Type of team colorprimary, secondary |
red | team_color - rgb-color | Integer | Team RGB color code - Red ex. 2 |
green | team_color - rgb-color | Integer | Team RGB color code - Green ex. 73 |
blue | team_color - rgb-color | Integer | Team RGB color code - Blue ex. 48 |
Coaches
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
experience | coach | String | Number of years coached in the NHL |
first_name | coach | String | First name of a coach ex. Dean |
full_name | coach | String | Full name of a coach ex. Dean Evason |
id | coach | GUID | Unique ID of a coach ex. 82482f14-45c3-42c3-adab-1f9592a68dcd |
last_name | coach | String | Last name of a coach ex. Evason |
position | coach | String | Position of a coach ex. Head Coach |
reference | coach | String | League reference ID of a coach ex. 8471675 |
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 |