⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Updates in realtime as changes are made to rosters or player profiles

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 captain `C`(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.`
`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`	`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 injury `Unknown`, `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 color `primary`, `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`

200200