ID Handling
Intro to IDs
Our NHL API features a number of unique identifiers. Some IDs are needed to request feeds, while others signify unique data.
IDs can be attributed to leagues, conferences, divisions, teams, venues, players, coaches, transfers, periods, in-game events, and many other elements.
ID Types
There are two primary ID types attributed to a variety of variables:
- UUIDs (Universally Unique Identifiers)
- SR IDs (Sportradar Identifiers)
Each directly identifies a given variable within the API, across multiple Sportradar APIs, or within data outside of Sportradar. The forms of IDs within the NHL API are detailed below.
UUID IDs
These are the primary IDs we suggest to implement in your integration.
UUIDs follow a specific structure: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
You'll see these UUIDs for teams, players, games, seasons, and more.
<team id="4415ce44-0f24-11e2-8525-18a905767e44" name="Avalanche" market="Colorado" alias="COL"/>SR IDs
These IDs correlate to our General Sport APIs, in this case the Global Ice Hockey API. They can have a varying structure but always begin with sr: and end with a number.
<competitor id="sr:competitor:3696" name="San Jose Sharks" country="USA" country_code="USA" abbreviation="SJ" gender="male"/>These IDs may appear as an id or a sr_id in various APIs.
<team xmlns="http://feed.elasticstats.com/schema/hockey/team-v7.0.xsd" id="4416091c-0f24-11e2-8525-18a905767e44" name="Wild" market="Minnesota" alias="MIN" sr_id="sr:team:3689" founded="2000" owner="Craig Leipold" general_manager="Bill Guerin" president="Bill Guerin" mascot="Nordy" sponsor="TRIA Orthopedics" championships_won="0" presidents_trophies="0" conference_titles="0" division_titles="1" playoff_appearances="14" minorleague_affiliate="Iowa Wild, Iowa Heartlanders" reference="30">
Important NoteThe
sr_idis an optional value in the NHL API and it’s strongly encouraged to utilize the UUIDs as your primary key. If you are integrating with the Global Ice Hockey API or any of our Odds APIs, the sr_ids will be needed.
IDs in other SR Products
NCAA Men's Hockey
Many NHL players previously competed in NCAA men’s hockey and therefore have profiles and IDs in the NCAA Men’s Hockey API. However, those NCAA IDs do not carry over to the NHL API; players receive distinct NHL IDs.
NCAA API player IDs are present in the NHL Team Profile and Player Profile feeds under the source_id.
<player id="4ade9aec-61a6-4391-9ef1-cbfc1c92a9e3" status="ACT" full_name="Macklin Celebrini" first_name="Macklin" last_name="Celebrini" abbr_name="M.Celebrini" height="72" weight="190" handedness="L" position="F" primary_position="C" jersey_number="71" college="Boston University" experience="1" birth_place="North Vancouver, BC, CAN" birthdate="2006-06-13" updated="2025-07-20T18:09:47Z" sr_id="sr:player:2740199" reference="8484801" rookie_year="2024" salary="975000">
<references>
<reference source_id="8484801" scope="NHL" id_type="external"/>
<reference source_id="5df2d390-3ac0-4c43-97a7-4fbcdaad2232" scope="hockey" id_type="sport_profile"/>
<reference source_id="2a97d5bb-0697-4b17-a6af-d935063dc1b5" scope="NCAAMH" id_type="league_profile"/>
</references>You may also leverage the Mapping Feeds within the Global Ice Hocky API should you need to link Sportradar IDs. These Mapping feeds provide id and sr_id links for teams, players, games, and seasons.
<mapping external_id="42919aaf-0f24-11e2-8525-18a905767e44" id="sr:competitor:579119"/>
<mapping external_id="72d92fa8-71ce-4437-adb5-e861e5f6f55f" id="sr:competitor:579045"/>
<mapping external_id="d57c7da4-b733-4137-94d3-388dd2b60cba" id="sr:competitor:578957"/>
<mapping external_id="6b66f634-a55b-11e2-a01b-f4ce4684ea4c" id="sr:competitor:578951"/>
<mapping external_id="398e4a3e-5e9b-4a81-8b23-32c21f27809a" id="sr:competitor:578891"/> <mapping external_id="98c85be0-dcf7-400f-8686-dde374b17bba" id="sr:player:1215056"/>
<mapping external_id="ce312459-7c09-49f9-9a68-d743ab5682c9" id="sr:player:1497749"/>
<mapping external_id="296747a6-c81a-43c0-aa5b-4d79dfbda66a" id="sr:player:1214010"/>
<mapping external_id="774aef55-1706-40a2-8d9b-9d09f01acbca" id="sr:player:1403207"/>
<mapping external_id="7988ba53-5b37-4cc6-bfd6-92c08da5f5f7" id="sr:player:1270684"/> <mapping external_id="e5565a6f-53c4-412a-8d27-8fb7f914adda" id="sr:sport_event:61933908"/>
<mapping external_id="3c719bce-c8a4-4f84-9807-49bd5ede8bc0" id="sr:sport_event:61933910"/>
<mapping external_id="6db75af1-14c4-4d97-bf86-01c8fc1b6525" id="sr:sport_event:61884816"/>
<mapping external_id="99d0a72b-59b3-4471-a26d-5be3dd37e5a6" id="sr:sport_event:61472887"/>
<mapping external_id="d03ddfe7-0014-4bb8-8b5e-4aa325cd4ea9" id="sr:sport_event:61472885"/> <mapping external_id="4a67cca6-b450-45f9-91c6-48e92ac19069" id="sr:season:131629"/>
<mapping external_id="4383ec83-6112-47f0-867a-8839145e1d58" id="sr:season:131825"/>
<mapping external_id="89d406e7-9d45-4e55-bdb3-5bf2a95b26d4" id="sr:season:119985"/>
<mapping external_id="ca35f7b9-e22c-4e52-a3d6-50ae05e005bf" id="sr:season:120519"/>
<mapping external_id="c5ca79d2-9e65-4987-84da-6f26237a47b3" id="sr:season:119985"/>Global Ice Hockey
The Global Ice Hockey API covers NHL data at a much lower tier, and is based on the sr_id system, with IDs that look like: sr:competitor:579119 or sr:sport_event:61933908.
Make use of the Mapping Feeds within Global Ice Hockey should you need to link IDs between APIs. These feeds provide id and sr_id links for teams, players, games, and seasons.
<mapping external_id="42919aaf-0f24-11e2-8525-18a905767e44" id="sr:competitor:579119"/>
<mapping external_id="72d92fa8-71ce-4437-adb5-e861e5f6f55f" id="sr:competitor:579045"/>
<mapping external_id="d57c7da4-b733-4137-94d3-388dd2b60cba" id="sr:competitor:578957"/>
<mapping external_id="6b66f634-a55b-11e2-a01b-f4ce4684ea4c" id="sr:competitor:578951"/>
<mapping external_id="398e4a3e-5e9b-4a81-8b23-32c21f27809a" id="sr:competitor:578891"/> <mapping external_id="98c85be0-dcf7-400f-8686-dde374b17bba" id="sr:player:1215056"/>
<mapping external_id="ce312459-7c09-49f9-9a68-d743ab5682c9" id="sr:player:1497749"/>
<mapping external_id="296747a6-c81a-43c0-aa5b-4d79dfbda66a" id="sr:player:1214010"/>
<mapping external_id="774aef55-1706-40a2-8d9b-9d09f01acbca" id="sr:player:1403207"/>
<mapping external_id="7988ba53-5b37-4cc6-bfd6-92c08da5f5f7" id="sr:player:1270684"/> <mapping external_id="e5565a6f-53c4-412a-8d27-8fb7f914adda" id="sr:sport_event:61933908"/>
<mapping external_id="3c719bce-c8a4-4f84-9807-49bd5ede8bc0" id="sr:sport_event:61933910"/>
<mapping external_id="6db75af1-14c4-4d97-bf86-01c8fc1b6525" id="sr:sport_event:61884816"/>
<mapping external_id="99d0a72b-59b3-4471-a26d-5be3dd37e5a6" id="sr:sport_event:61472887"/>
<mapping external_id="d03ddfe7-0014-4bb8-8b5e-4aa325cd4ea9" id="sr:sport_event:61472885"/> <mapping external_id="4a67cca6-b450-45f9-91c6-48e92ac19069" id="sr:season:131629"/>
<mapping external_id="4383ec83-6112-47f0-867a-8839145e1d58" id="sr:season:131825"/>
<mapping external_id="89d406e7-9d45-4e55-bdb3-5bf2a95b26d4" id="sr:season:119985"/>
<mapping external_id="ca35f7b9-e22c-4e52-a3d6-50ae05e005bf" id="sr:season:120519"/>
<mapping external_id="c5ca79d2-9e65-4987-84da-6f26237a47b3" id="sr:season:119985"/>
AccessPlease note that you will need access to the Global Ice Hockey API in your account to make use of these endpoints.
Odds
The Odds APIs include NHL odds data, and are based on the sr_id system, with IDs that look like: sr:competitor:579119 or sr:sport_event:61933908.
Make use of the Mapping Feeds within each Odds API should you need to link IDs between APIs. These feeds provide id and sr_id links for leagues (Competitions), teams (Competitors), players, and games (Sport Events).
<mapping external_id="64e90d00-9ea0-4c91-8292-e78414439d54" id="sr:competition:8"/>
<mapping external_id="ea97fe54-4712-4bd7-b643-8409887f9f61" id="sr:competition:16"/>
<mapping external_id="fdc32c0e-2a6a-4bbe-b855-41fef6369bfe" id="sr:competition:17"/>
<mapping external_id="cd24a25b-3fc0-48fd-9c54-f793d51af976" id="sr:competition:23"/>
<mapping external_id="3c6d318a-6164-4290-9bbc-bf9bb21cc4b8" id="sr:competition:31"/> <mapping external_id="65da41c2-5231-42a1-acb9-7fe295b12fc7" id="sr:competitor:1"/>
<mapping external_id="eb9aa424-85af-443d-a7c1-8a8614637d8e" id="sr:competitor:2"/>
<mapping external_id="b1ef96b0-be25-48b6-b6c5-c4d876116110" id="sr:competitor:3"/>
<mapping external_id="2c669de5-7b24-46f2-8d2b-715784f8ac4d" id="sr:competitor:4"/>
<mapping external_id="b8c90280-978c-40fc-8cb8-35996992825f" id="sr:competitor:5"/> <mapping external_id="036f914a-aad0-4ff1-9771-54f9e963d1b8" id="sr:player:996277"/>
<mapping external_id="252f4b13-6abb-45dc-ae85-f822b817cb51" id="sr:player:1605464"/>
<mapping external_id="31a50d54-ef46-47a8-863c-6f4d4e5aa184" id="sr:player:607928"/>
<mapping external_id="3f64e9a6-6e1e-499b-aec8-764c99f634b2" id="sr:player:857970"/>
<mapping external_id="51ee792b-20c1-4ce5-b123-53fa05cb943e" id="sr:player:922298"/> <mapping external_id="5ca22b1c-3ede-4a91-bbe8-456179e8e230" id="sr:sport_event:50733635"/>
<mapping external_id="ab166a44-3adb-4195-ab29-ca60eb2ea7c8" id="sr:sport_event:50690883"/>
<mapping external_id="a75e6ddd-6570-4584-9323-9bb363f40cf3" id="sr:sport_event:50690877"/>
<mapping external_id="eee98b92-75b6-474e-a27f-43e562baeb2b" id="sr:sport_event:50690787"/>
<mapping external_id="dbfa2bd2-15c2-46a6-bfd4-75b8543a970a" id="sr:sport_event:50690785"/>
AccessPlease note that you will need access to the Odds APIs in your account to make use of these endpoints.
Images & Editorial
Our Images and Editorial APIs include both UUID and SR IDs within image and article entries (under entity_id). This allows you to sync player, team, and game IDs to this content.
<?xml version="1.0" encoding="UTF-8"?>
<assetlist xmlns="http://feed.elasticstats.com/schema/assets/manifest-v2.5.xsd" provider="usat" league="nhl" type="headshot" entity="players" manifest_date="2025-02-10T22:15:23+00:00">
<asset id="002d7ce7-914e-468f-895b-5905a7907de7" created="2024-10-17T21:25:06+00:00" updated="2024-10-17T21:25:19+00:00" player_id="5826c1cb-f2cf-4eb6-b516-84685164cc60" posed="false">
<title>
<![CDATA[Shane Wright]]>
</title>
<description>
<![CDATA[NHL: 2024 Season Player Headshots]]>
</description>
<copyright>USA Today Sports Images</copyright>
<links>
<link width="1200" height="1200" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/original.jpg"/>
<link width="250" height="250" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/250w-resize.jpg"/>
<link width="205" height="205" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/205x205-crop.jpg"/>
<link width="90" height="90" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/90x90-crop.jpg"/>
<link width="250" height="250" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/250x250-crop.jpg"/>
<link width="195" height="270" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/195x270-crop.jpg"/>
<link width="940" height="940" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/940x940-crop.jpg"/>
<link width="200" height="300" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/200x300-crop.jpg"/>
<link width="160" height="160" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/160x160-crop.jpg"/>
<link width="160" height="160" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/160x160-crop.jpg"/>
<link width="135" height="135" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/135x135-crop.jpg"/>
<link width="300" height="300" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/300x300-crop.jpg"/>
<link width="600" height="600" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/600x600-crop.jpg"/>
<link width="705" height="705" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/705x705-crop.jpg"/>
<link width="150" height="150" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/150x150-crop.jpg"/>
<link width="820" height="820" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/820x820-crop.jpg"/>
<link width="40" height="40" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/40x40-crop.jpg"/>
<link width="60" height="60" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/60x60-crop.jpg"/>
<link width="615" height="615" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/615x615-crop.jpg"/>
<link width="235" height="235" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/235x235-crop.jpg"/>
<link width="450" height="450" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/450x450-crop.jpg"/>
<link width="470" height="470" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/470x470-crop.jpg"/>
<link width="240" height="240" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/240x240-crop.jpg"/>
<link width="90" height="90" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/90x90-crop.jpg"/>
<link width="120" height="120" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/120x120-crop.jpg"/>
<link width="80" height="80" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/80x80-crop.jpg"/>
<link width="45" height="45" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/45x45-crop.jpg"/>
<link width="180" height="180" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/180x180-crop.jpg"/>
<link width="410" height="410" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/410x410-crop.jpg"/>
<link width="300" height="300" href="/headshots/players/002d7ce7-914e-468f-895b-5905a7907de7/300w-resize.jpg"/>
</links>
<refs>
<ref name="Wright, Shane" type="profile" sport="nhl" sportradar_id="5826c1cb-f2cf-4eb6-b516-84685164cc60" primary="true">
<entity_id origin="SR" id="sr:player:2101756" sport="nhl"/>
<entity_id origin="SD" id="5826c1cb-f2cf-4eb6-b516-84685164cc60" sport="nhl"/>
</ref>
<ref name="Seattle Kraken" type="organization" sport="nhl" sportradar_id="1fb48e65-9688-4084-8868-02173525c3e1">
<entity_id origin="SR" id="sr:competitor:794340" sport="nhl"/>
<entity_id origin="SD" id="1fb48e65-9688-4084-8868-02173525c3e1" sport="nhl"/>
<entity_id origin="NHL" id="55" sport="nhl"/>
</ref>
</refs>
<provider name="usat">
<provider_item_id>24513413</provider_item_id>
<original_publish>2024-10-17T17:10:29+00:00</original_publish>
</provider>
</asset><?xml version="1.0" encoding="UTF-8"?>
<content xmlns="http://feed.elasticstats.com/schema/editorial/content-v2.5.xsd" provider="ap" sport="nhl" start_time="2025-01-14T00:00:00Z" end_time="2025-01-14T23:59:59Z" manifest_date="2025-01-15T00:52:36+00:00">
<item id="033258ca-a28d-4721-a067-38eda75dd992" type="preview" created="2025-01-14T09:12:14+00:00" updated="2025-01-14T09:12:18+00:00" injury="false" transaction="false">
<title>
<![CDATA[Blue Jackets bring win streak into home matchup with the Flyers]]>
</title>
<byline>By The Associated Press</byline>
<credit>Data Skrive</credit>
<content>
<long>
<![CDATA[Blue Jackets bring win streak into home matchup with the Flyers By The Associated Press The Associated Press Philadelphia Flyers (19-20-5, in the Metropolitan Division) vs. Columbus Blue Jackets (20-17-6, in the Metropolitan Division) Columbus, Ohio; Tuesday, 7 p.m. EST BETMGM SPORTSBOOK LINE: Blue Jackets -118, Flyers -102; over/under is 6.5 BOTTOM LINE: The Columbus Blue Jackets are looking to prolong a four-game win streak with a victory over the Philadelphia Flyers. Columbus has gone 20-17-6 overall with a 6-3-2 record against the Metropolitan Division. The Blue Jackets have scored 146 total goals (3.4 per game) to rank sixth in league play. Philadelphia has a 19-20-5 record overall and a 3-5-0 record in Metropolitan Division games. The Flyers have allowed 152 goals while scoring 133 for a -19 scoring differential. The matchup Tuesday is the third time these teams square off this season. The Flyers won 5-4 in overtime in the last meeting. Morgan Frost led the Flyers with two goals. TOP PERFORMERS: Kirill Marchenko has 18 goals and 29 assists for the Blue Jackets. Dmitri Voronkov has nine goals and six assists over the last 10 games. Travis Konecny has 20 goals and 30 assists for the Flyers. Noah Cates has scored four goals and added four assists over the past 10 games. LAST 10 GAMES: Blue Jackets: 7-2-1, averaging 3.9 goals, 7.1 assists, 3.2 penalties and 7.3 penalty minutes while giving up 3.3 goals per game. Flyers: 4-5-1, averaging 3.1 goals, 5.4 assists, 3.3 penalties and 7.2 penalty minutes while giving up 2.8 goals per game. INJURIES: Blue Jackets: None listed. Flyers: None listed. ___ The Associated Press created this story using technology provided by Data Skrive and data from Sportradar .]]>
</long>
<long_html>
<![CDATA[<p>Philadelphia Flyers (19-20-5, in the Metropolitan Division) vs. Columbus Blue Jackets (20-17-6, in the Metropolitan Division)</p><p>Columbus, Ohio; Tuesday, 7 p.m. EST</p><p><a href="http://betmgm.com/" rel="nofollow">BETMGM SPORTSBOOK LINE:</a> Blue Jackets -118, Flyers -102; over/under is 6.5</p><p>BOTTOM LINE: The Columbus Blue Jackets are looking to prolong a four-game win streak with a victory over the Philadelphia Flyers.</p><p>Columbus has gone 20-17-6 overall with a 6-3-2 record against the Metropolitan Division. The Blue Jackets have scored 146 total goals (3.4 per game) to rank sixth in league play.</p><p>Philadelphia has a 19-20-5 record overall and a 3-5-0 record in Metropolitan Division games. The Flyers have allowed 152 goals while scoring 133 for a -19 scoring differential.</p><p>The matchup Tuesday is the third time these teams square off this season. The Flyers won 5-4 in overtime in the last meeting. Morgan Frost led the Flyers with two goals.</p><p>TOP PERFORMERS: Kirill Marchenko has 18 goals and 29 assists for the Blue Jackets. Dmitri Voronkov has nine goals and six assists over the last 10 games.</p><p>Travis Konecny has 20 goals and 30 assists for the Flyers. Noah Cates has scored four goals and added four assists over the past 10 games.</p><p>LAST 10 GAMES: Blue Jackets: 7-2-1, averaging 3.9 goals, 7.1 assists, 3.2 penalties and 7.3 penalty minutes while giving up 3.3 goals per game.</p><p>Flyers: 4-5-1, averaging 3.1 goals, 5.4 assists, 3.3 penalties and 7.2 penalty minutes while giving up 2.8 goals per game.</p><p>INJURIES: Blue Jackets: None listed.</p><p>Flyers: None listed.</p><p>___</p><p>The Associated Press created this story using technology provided by <a href="https://www.dataskrive.com/">Data Skrive</a> and data from <a href="https://www.sportradar.com">Sportradar</a>.</p>]]>
</long_html>
</content>
<refs>
<ref name="Cates, Noah" type="profile" sport="nhl" sportradar_id="d31f8b5a-2cdc-4728-b2e9-1b95279d7c6a">
<entity_id origin="SR" id="sr:player:1144946" sport="nhl"/>
<entity_id origin="SD" id="d31f8b5a-2cdc-4728-b2e9-1b95279d7c6a" sport="nhl"/>
</ref>
<ref name="Columbus Blue Jackets" type="organization" sport="nhl" sportradar_id="44167db4-0f24-11e2-8525-18a905767e44">
<entity_id origin="SR" id="sr:team:3683" sport="nhl"/>
<entity_id origin="SD" id="44167db4-0f24-11e2-8525-18a905767e44" sport="nhl"/>
</ref>
<ref name="Frost, Morgan" type="profile" sport="nhl" sportradar_id="2c7ee210-6e8d-4a01-b757-a5b8fde14f65">
<entity_id origin="SR" id="sr:player:1117777" sport="nhl"/>
<entity_id origin="SD" id="2c7ee210-6e8d-4a01-b757-a5b8fde14f65" sport="nhl"/>
</ref>
<ref name="Konecny, Travis" type="profile" sport="nhl" sportradar_id="9d563de3-c77f-4b9d-a570-77d1a8049569">
<entity_id origin="SR" id="sr:player:852944" sport="nhl"/>
<entity_id origin="SD" id="9d563de3-c77f-4b9d-a570-77d1a8049569" sport="nhl"/>
</ref>
<ref name="Marchenko, Kirill" type="profile" sport="nhl" sportradar_id="7710571c-737e-49f4-846f-3719108832a9">
<entity_id origin="SR" id="sr:player:1403077" sport="nhl"/>
<entity_id origin="SD" id="7710571c-737e-49f4-846f-3719108832a9" sport="nhl"/>
</ref>
<ref name="PHI at CBJ (NHL - 1/14/2025)" type="event" sport="nhl" sportradar_id="9820e2fa-62d8-4927-bc79-d60982de43af">
<entity_id origin="SR" id="sr:match:51247117" sport="nhl"/>
<entity_id origin="SD" id="9820e2fa-62d8-4927-bc79-d60982de43af" sport="nhl"/>
</ref>
<ref name="Philadelphia Flyers" type="organization" sport="nhl" sportradar_id="44179d47-0f24-11e2-8525-18a905767e44">
<entity_id origin="SR" id="sr:competitor:3699" sport="nhl"/>
<entity_id origin="SD" id="44179d47-0f24-11e2-8525-18a905767e44" sport="nhl"/>
</ref>
<ref name="Voronkov, Dmitri" type="profile" sport="nhl" sportradar_id="d938417d-e2d3-41ea-a4d5-8b29b3cf2258">
<entity_id origin="SR" id="sr:player:1705467" sport="nhl"/>
<entity_id origin="SD" id="d938417d-e2d3-41ea-a4d5-8b29b3cf2258" sport="nhl"/>
</ref>
</refs>
<provider name="ap">
<provider_content_id>f5ac95816f074137834d621a3b693184</provider_content_id>
<version>1</version>
<original_link>https://api.ap.org/media/v/content/f5ac95816f074137834d621a3b693184?qt=3j4A8hJ8n0eS&et=0a2aza0c0</original_link>
<original_publish>2025-01-14T09:09:55+00:00</original_publish>
</provider>
</item>Widgets
Our NHL Widgets often will require the input of a unique game, team, player, or season ID. Each of these are the UUIDs found in the NHL API.
Game IDs
Each NHL game will have its own unique identifier under game.id. See below for a sample taken from the Schedule endpoint.
<games>
<game id="2c79c49d-c247-42c4-9126-a65c0ec1a1be" status="closed" coverage="full" scheduled="2024-10-04T17:00:00Z" home_points="1" away_points="4" sr_id="sr:match:51245721" reference="20001" home_team="4416d559-0f24-11e2-8525-18a905767e44" away_team="44174b0c-0f24-11e2-8525-18a905767e44">
<venue id="60292fc3-ed44-45e9-a3bf-87ee71716a38" name="O2 Arena" capacity="17383" address="Ceskomoravska 2345/17" city="Prague" country="CZE" time_zone="Europe/Vienna" sr_id="sr:venue:5520">
<location lat="50.10495" lng="14.49368"/>
</venue>
<time_zones venue="Europe/Vienna" home="US/Eastern" away="US/Eastern"/>
<home id="4416d559-0f24-11e2-8525-18a905767e44" name="Buffalo Sabres" alias="BUF" sr_id="sr:team:3678" reference="7">
</home>
<away id="44174b0c-0f24-11e2-8525-18a905767e44" name="New Jersey Devils" alias="NJ" sr_id="sr:team:3704" reference="1">
</away>
<broadcasts>
<broadcast network="NHL Network" type="TV" locale="National" channel="215"/>
<broadcast network="MSG-B" type="TV" locale="Home" channel="635-1"/>
<broadcast network="MSGSN" type="TV" locale="Away" channel="635"/>
</broadcasts>
</game>"games": [
{
"id": "2c79c49d-c247-42c4-9126-a65c0ec1a1be",
"status": "closed",
"coverage": "full",
"scheduled": "2024-10-04T17:00:00Z",
"home_points": 1,
"away_points": 4,
"sr_id": "sr:match:51245721",
"reference": "20001",
"time_zones": {
"venue": "Europe/Vienna",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "60292fc3-ed44-45e9-a3bf-87ee71716a38",
"name": "O2 Arena",
"capacity": 17383,
"address": "Ceskomoravska 2345/17",
"city": "Prague",
"country": "CZE",
"time_zone": "Europe/Vienna",
"sr_id": "sr:venue:5520",
"location": {
"lat": "50.10495",
"lng": "14.49368"
}
},
"broadcasts": [
{
"network": "NHL Network",
"type": "TV",
"locale": "National",
"channel": "215"
},
{
"network": "MSG-B",
"type": "TV",
"locale": "Home",
"channel": "635-1"
},
{
"network": "MSGSN",
"type": "TV",
"locale": "Away",
"channel": "635"
}
],
"home": {
"id": "4416d559-0f24-11e2-8525-18a905767e44",
"name": "Buffalo Sabres",
"alias": "BUF",
"sr_id": "sr:team:3678",
"reference": "7"
},
"away": {
"id": "44174b0c-0f24-11e2-8525-18a905767e44",
"name": "New Jersey Devils",
"alias": "NJ",
"sr_id": "sr:team:3704",
"reference": "1"
}
},Once created, game IDs are unchanging, except in the rare case that a game is postponed, or a game is mistakenly created twice (the duplicated UUID would be removed).
Team IDs
Each NHL team will have its own unique identifier under team.id. You can locate all active teams in the League Hierarchy feed, and all active teams in our NHL database in the Teams feed.
<team id="4415ce44-0f24-11e2-8525-18a905767e44" name="Avalanche" market="Colorado" alias="COL"/>
<team id="4416272f-0f24-11e2-8525-18a905767e44" name="Blackhawks" market="Chicago" alias="CHI"/>
<team id="44167db4-0f24-11e2-8525-18a905767e44" name="Blue Jackets" market="Columbus" alias="CBJ"/>
<team id="441660ea-0f24-11e2-8525-18a905767e44" name="Blues" market="St. Louis" alias="STL"/>
<team id="4416ba1a-0f24-11e2-8525-18a905767e44" name="Bruins" market="Boston" alias="BOS"/> {
"id": "7ab1c9c0-4ffa-4f27-bcb6-be54d6ca6127",
"name": "EASTERN CONFERENCE",
"alias": "EASTERN",
"divisions": [
{
"id": "d5ec45c4-a691-43ac-9e6d-92de92e763e7",
"name": "Metropolitan",
"alias": "METROPOLITAN",
"teams": [
{
"id": "44174b0c-0f24-11e2-8525-18a905767e44",
"name": "Devils",
"market": "New Jersey",
"alias": "NJ",
"sr_id": "sr:team:3704",
"founded": 1974,
"owner": "David Blitzer and Josh Harris",
"general_manager": "Tom Fitzgerald",
"president": "Jake Reynolds",
"mascot": "NJ Devil",
"sponsor": "RWJBarnabas Health",
"minorleague_affiliate": "Utica Comets, Adirondack Thunder",
"reference": "1",
"venue": {
"id": "c970f791-c3bf-411e-89c6-952695afd414",
"name": "Prudential Center",
"capacity": 16514,
"address": "25 Lafayette Street",
"city": "Newark",
"state": "NJ",
"zip": "07102",
"country": "USA",
"time_zone": "US/Eastern",
"sr_id": "sr:venue:6048",
"location": {
"lat": "40.73380931921417",
"lng": "-74.17104444444301"
}
},
"team_colors": [
{
"type": "secondary",
"hex_color": "#000000",
"rgb_color": {
"red": 0,
"green": 0,
"blue": 0
}
},
{
"type": "primary",
"hex_color": "#ce1126",
"rgb_color": {
"red": 206,
"green": 17,
"blue": 38
}
}
]
},
{
"id": "4417eede-0f24-11e2-8525-18a905767e44",
"name": "Capitals",
"market": "Washington",
"alias": "WSH",
"sr_id": "sr:team:3691",
"founded": 1974,
"owner": "Ted Leonsis",
"general_manager": "Chris Patrick",
"president": "Brian MacLellan",
"mascot": "Slapshot",
"nicknames": "Caps",
"sponsor": "Caesars Sportsbook",
"minorleague_affiliate": "Hershey Bears, South Carolina Stingrays",
"reference": "15",
"venue": {
"id": "48f092ed-ce49-4a08-97c6-def284ba6721",
"name": "Capital One Arena",
"capacity": 18277,
"address": "601 F Street NW",
"city": "Washington",
"state": "DC",
"zip": "20004",
"country": "USA",
"time_zone": "US/Eastern",
"sr_id": "sr:venue:6016",
"location": {
"lat": "38.89841",
"lng": "-77.02080"
}
},
"team_colors": [
{
"type": "primary",
"hex_color": "#c8102e",
"rgb_color": {
"red": 200,
"green": 16,
"blue": 46
}
},
{
"type": "secondary",
"hex_color": "#041e42",
"rgb_color": {
"red": 4,
"green": 30,
"blue": 66
}
}
]
}
]
}
]
}Team Relocation
Team IDs will not change once created. If a team relocates we will create a new team ID.
TBD Teams
Within the Teams feed, you will find a TBD team. This unique ID can be used to populate game information when game matchups are not yet known.
Find the TBD team in the Teams endpoint.
<team id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" name="TBD" alias="TBD" market="Team"/>
Note: Although the following example is shown using the NBA API, the response structure and use of time-tbd are the same in the NHL API.
TBD Team Samples
<series id="0f81bb4d-1d0c-4a3b-82de-507534154095" title="NBA Finals - TBD vs TBD" round="4" start_date="2024-06-06" status="scheduled">
<games>
<game id="342f103b-0fd7-47ac-a84d-1391e3605e96" status="time-tbd" title="Game 1" coverage="full" scheduled="2024-06-06T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
<game id="71d8d5fc-6836-43c1-85a0-61a828296a06" status="time-tbd" title="Game 2" coverage="full" scheduled="2024-06-09T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
<game id="50b170b9-37e2-47d0-b517-e56ebb960cba" status="time-tbd" title="Game 3" coverage="full" scheduled="2024-06-12T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
<game id="8e94445c-c223-4a49-a759-0b651e440b95" status="time-tbd" title="Game 4" coverage="full" scheduled="2024-06-14T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
<game id="aaa3ddb3-dd1b-459e-a686-d2bfc4408881" status="if-necessary" title="Game 5 (if necessary)" coverage="full" scheduled="2024-06-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
<game id="7c16f1ec-6629-4675-aaaa-2a31835862a6" status="if-necessary" title="Game 6 (if necessary)" coverage="full" scheduled="2024-06-20T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
<game id="09129676-2320-4151-976d-713ea785d97b" status="if-necessary" title="Game 7 (if necessary)" coverage="full" scheduled="2024-06-23T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
<time_zones/>
<home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
</away>
</game>
</games>
</series>"series": [
{
"id": "0f81bb4d-1d0c-4a3b-82de-507534154095",
"title": "NBA Finals - TBD vs TBD",
"round": 4,
"start_date": "2024-06-06",
"status": "scheduled",
"participants": [],
"games": [
{
"id": "342f103b-0fd7-47ac-a84d-1391e3605e96",
"status": "time-tbd",
"title": "Game 1",
"coverage": "full",
"scheduled": "2024-06-06T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
},
{
"id": "71d8d5fc-6836-43c1-85a0-61a828296a06",
"status": "time-tbd",
"title": "Game 2",
"coverage": "full",
"scheduled": "2024-06-09T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
},
{
"id": "50b170b9-37e2-47d0-b517-e56ebb960cba",
"status": "time-tbd",
"title": "Game 3",
"coverage": "full",
"scheduled": "2024-06-12T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
},
{
"id": "8e94445c-c223-4a49-a759-0b651e440b95",
"status": "time-tbd",
"title": "Game 4",
"coverage": "full",
"scheduled": "2024-06-14T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
},
{
"id": "aaa3ddb3-dd1b-459e-a686-d2bfc4408881",
"status": "if-necessary",
"title": "Game 5 (if necessary)",
"coverage": "full",
"scheduled": "2024-06-17T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
},
{
"id": "7c16f1ec-6629-4675-aaaa-2a31835862a6",
"status": "if-necessary",
"title": "Game 6 (if necessary)",
"coverage": "full",
"scheduled": "2024-06-20T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
},
{
"id": "09129676-2320-4151-976d-713ea785d97b",
"status": "if-necessary",
"title": "Game 7 (if necessary)",
"coverage": "full",
"scheduled": "2024-06-23T17:00:00+00:00",
"neutral_site": false,
"track_on_court": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
}
}
]
},Player IDs
Each NHL player will have their own unique identifier under player.id. You can locate all active players on a given team in the Team Profile endpoint, and retrieve detailed player biographical info and stats in the Player Profile endpoint.
Player IDs will not change once created.
<team xmlns="http://feed.elasticstats.com/schema/hockey/team-v7.0.xsd" id="4416091c-0f24-11e2-8525-18a905767e44" name="Wild" market="Minnesota" alias="MIN" sr_id="sr:team:3689" founded="2000" owner="Craig Leipold" general_manager="Bill Guerin" president="Bill Guerin" mascot="Nordy" sponsor="TRIA Orthopedics" championships_won="0" presidents_trophies="0" conference_titles="0" division_titles="1" playoff_appearances="14" minorleague_affiliate="Iowa Wild, Iowa Heartlanders" reference="30">
<venue id="7e6f808b-eff8-42fd-a8e2-d35219f565bd" name="Grand Casino Arena" capacity="18064" address="199 W Kellogg Boulevard" city="St. Paul" state="MN" zip="55102" country="USA" time_zone="US/Central" sr_id="sr:venue:6020">
<location lat="44.94478" lng="-93.10118"/>
</venue>
<hierarchy>
<league id="fd560107-a85b-4388-ab0d-655ad022aff7" name="NHL" alias="NHL"/>
<conference id="64901512-9ca9-4bea-aa80-16dbcbdae230" name="WESTERN CONFERENCE" alias="WESTERN"/>
<division id="5e868c4d-c6a3-4901-bc3c-3b7a4509e402" name="Central" alias="CENTRAL"/>
</hierarchy>
<coaches>
<coach id="ec578504-5399-4d25-bb5a-f06a3198269c" full_name="John Hynes" first_name="John" last_name="Hynes" position="Head Coach" experience="11"/>
</coaches>
<team_colors>
<team_color type="primary" hex_color="#024930">
<rgb_color red="2" green="73" blue="48"/>
</team_color>
<team_color type="secondary" hex_color="#e2d6b5">
<rgb_color red="226" green="214" blue="181"/>
</team_color>
</team_colors>
<players>
<player id="03057f04-674c-11e2-9e6b-f4ce4684ea4c" status="ACT" full_name="Jonas Brodin" first_name="Jonas" last_name="Brodin" abbr_name="J.Brodin" height="74" weight="196" handedness="L" position="D" primary_position="D" jersey_number="25" experience="13" birth_place="Karlstad,, SWE" birthdate="1993-07-12" updated="2025-07-21T00:14:33Z" sr_id="sr:player:133684" reference="8476463" rookie_year="2012" salary="6000000">
<references>
<reference source_id="8476463" scope="NHL" id_type="external"/>
<reference source_id="6d7ada08-4774-469c-ab2f-281a14a4d5e3" scope="hockey" id_type="sport_profile"/>
</references>
<draft team_id="4416091c-0f24-11e2-8525-18a905767e44" year="2011" round="1" pick="10"/>
<injuries>
<injury id="130333c0-e4de-4a9a-bbe5-346387c9d84a" status="Out" start_date="2025-06-28" update_date="2025-06-28" comment="The Wild announced on Saturday (Jun. 28) that Brodin underwent surgery a few weeks ago and is unlikely to be ready for the start of the 2025-26 season, per Michael Russo of The Athletic." desc="Upper-body"/>
</injuries>
</player>
<player id="2afe3d22-7825-4549-a60f-083abcb438d2" status="ACT" full_name="Tyler Pitlick" first_name="Tyler" last_name="Pitlick" abbr_name="T.Pitlick" height="74" weight="200" handedness="R" position="F" primary_position="C" college="Minnesota State" experience="10" birth_place="Minneapolis, MN, USA" birthdate="1991-11-01" updated="2025-07-21T00:17:27Z" sr_id="sr:player:353830" reference="8475752" rookie_year="2013">
<references>
<reference source_id="8475752" scope="NHL" id_type="external"/>
<reference source_id="4c64b96f-6af3-443c-9381-d8bc58f20249" scope="hockey" id_type="sport_profile"/>
</references>
<draft team_id="4415ea6c-0f24-11e2-8525-18a905767e44" year="2010" round="2" pick="31"/>
</player>
<player id="2f11e3a8-a8d2-444a-aebb-647641adf8ea" status="UDP" full_name="Justin Kipkie" first_name="Justin" last_name="Kipkie" abbr_name="J.Kipkie" height="76" weight="207" handedness="L" position="D" primary_position="D" experience="0" birth_place="North Vancouver, BC, CAN" birthdate="2005-07-28" updated="2025-09-07T05:20:35Z" sr_id="sr:player:2413123" reference="8484434">
<references>
<reference source_id="8484434" scope="NHL" id_type="external"/>
<reference source_id="44508403-5c4c-42b7-b2a0-f6b12dfe2acf" scope="hockey" id_type="sport_profile"/>
<reference source_id="c47389e6-4e17-4878-a18e-d279ba63f207" scope="NCAAMH" id_type="league_profile"/>
</references>
<draft team_id="4416091c-0f24-11e2-8525-18a905767e44" year="2025" round="5" pick="141"/>
</player>{
"id": "42a966db-0f24-11e2-8525-18a905767e44",
"status": "NWT",
"full_name": "David Jones",
"first_name": "David",
"last_name": "Jones",
"abbr_name": "D.Jones",
"height": 74,
"weight": 210,
"handedness": "R",
"position": "F",
"primary_position": "RW",
"college": "Dartmouth",
"experience": "9",
"birth_place": "Guelph, ON, CAN",
"birthdate": "1984-08-10",
"updated": "2023-02-06T14:57:14Z",
"reference": "8470877",
"rookie_year": 2007,
"league": {
"id": "fd560107-a85b-4388-ab0d-655ad022aff7",
"name": "NHL",
"alias": "NHL"
},
"draft": {
"team_id": "4415ce44-0f24-11e2-8525-18a905767e44",
"year": 2003,
"round": "9",
"pick": "288"
},
"references": [
{
"source_id": "8470877",
"scope": "NHL",
"id_type": "external"
},
{
"source_id": "44ac5bd1-e1c0-4dbd-b138-3ce7122b2113",
"scope": "hockey",
"id_type": "sport_profile"
}
],
"seasons": [
{
"id": "a64701af-85bb-4cc0-bf72-15f6ba69757e",
"year": 2013,
"type": "REG",
"teams": [
{
"id": "44159241-0f24-11e2-8525-18a905767e44",
"name": "Flames",
"market": "Calgary",
"alias": "CGY",
"sr_id": "sr:team:3679",
"reference": "20",
"statistics": {
"total": {
"games_played": 48,
"goals": 9,
"assists": 8,
"penalties": 5,
"penalty_minutes": 10,
"shots": 104,
"blocked_att": 30,
"missed_shots": 34,
"hits": 102,
"giveaways": 13,
"takeaways": 15,
"blocked_shots": 31,
"faceoffs_won": 38,
"faceoffs_lost": 35,
"winning_goals": 1,
"plus_minus": 1,
"games_scratched": 34,
"games_started": 0,
"shooting_pct": 8.7,
"faceoff_win_pct": 52.1,
"faceoffs": 73,
"points": 17,
"emptynet_goals": 0,
"overtime_goals": 0,
"overtime_assists": 0,
"overtime_shots": 0,
"penalties_major": 0,
"penalties_match": 0,
"penalties_minor": 0,
"penalties_misconduct": 0
},
"powerplay": {
"shots": 11,
"goals": 2,
"missed_shots": 4,
"assists": 0,
"faceoffs_won": 0,
"faceoffs": 0,
"faceoffs_lost": 0,
"faceoff_win_pct": 0
},
"shorthanded": {
"shots": 0,
"goals": 0,
"missed_shots": 0,
"assists": 0,
"faceoffs_won": 0,
"faceoffs": 0,
"faceoffs_lost": 0,
"faceoff_win_pct": 0
},
"evenstrength": {
"shots": 93,
"goals": 7,
"missed_shots": 30,
"assists": 8,
"faceoffs_won": 0,
"faceoffs": 0,
"faceoffs_lost": 0,
"faceoff_win_pct": 0
},
"penalty": {
"shots": 0,
"goals": 0,
"missed_shots": 0
},
"shootout": {
"shots": 0,
"goals": 0,
"missed_shots": 0
},
"average": {
"assists": 0.17,
"blocked_shots": 0.65,
"points": 0.35,
"blocked_att": 0.63,
"penalties": 0.1,
"missed_shots": 0.71,
"hits": 2.13,
"shots": 2.17,
"takeaways": 0.31,
"giveaways": 0.27,
"goals": 0.19,
"penalty_minutes": 0.21
}
},
"time_on_ice": {
"total": {
"shifts": 1080,
"total": "742:04",
"overtime": "00:00",
"powerplay": "00:00",
"shorthanded": "00:00",
"evenstrength": "742:04"
},
"average": {
"shifts": 22.5,
"total": "15:28",
"overtime": "00:00",
"powerplay": "00:00",
"shorthanded": "00:00",
"evenstrength": "15:28"
}
}
}
]
},Player IDs in other Products
Each NHL player.id is specific to the NHL API. IDs will not transfer to other ice hockey APIs. To learn more about linking IDs across API products visit this section.
Duplicate Player IDs
A duplicate player profile (and player.id) can be introduced by mistake. In these cases, we will mark the duplicate player with a status of DUP. All profiles marked as duplicates can be ignored, but they will remain in our database to limit confusion.
<player id="428279e7-0f24-11e2-8525-18a905767e44" status="DUP" full_name="Jack Johnson" first_name="Jack" last_name="Johnson" abbr_name="J.Johnson" height="74" weight="225" handedness="L" position="D" primary_position="D" college="Michigan" experience="18" birth_place="Indianapolis, IN, USA" birthdate="1987-01-13" updated="2025-08-12T17:06:05Z" sr_id="sr:player:29602" reference="8471677" rookie_year="2006">
</player>{
"id": "428279e7-0f24-11e2-8525-18a905767e44",
"status": "DUP",
"full_name": "Jack Johnson",
"first_name": "Jack",
"last_name": "Johnson",
"abbr_name": "J.Johnson",
"height": 74,
"weight": 225,
"handedness": "L",
"position": "D",
"primary_position": "D",
"college": "Michigan",
"experience": "18",
"birth_place": "Indianapolis, IN, USA",
"birthdate": "1987-01-13",
"updated": "2025-08-12T17:06:05Z",
"sr_id": "sr:player:29602",
"reference": "8471677",
"rookie_year": 2006,
"references": [
{
"source_id": "8471677",
"scope": "NHL",
"id_type": "external"
},Season IDs
Each NHL season will have its own unique identifier under season.id. Season types can be PRE (Preseason), REG (Regular season), or PST (Postseason). You can locate all historical seasons in the Seasons feed.
Season IDs will not change once created.
<season id="89d406e7-9d45-4e55-bdb3-5bf2a95b26d4" year="2024" start_date="2025-04-19" end_date="2025-06-17" status="closed">
<type code="PST" name="Post-season"/>
</season>
<season id="c5ca79d2-9e65-4987-84da-6f26237a47b3" year="2024" start_date="2024-10-04" end_date="2025-04-17" status="closed">
<type code="REG" name="Regular Season"/>
</season>
<season id="ca35f7b9-e22c-4e52-a3d6-50ae05e005bf" year="2024" start_date="2024-09-21" end_date="2024-10-07" status="closed">
<type code="PRE" name="Pre-season"/>
</season>
<season id="3c1bb21f-6523-4115-87ee-c8c16ed80421" year="2025" start_date="2026-04-18" status="scheduled">
<type code="PST" name="Post-season"/>
</season>
<season id="4a67cca6-b450-45f9-91c6-48e92ac19069" year="2025" start_date="2025-10-07" end_date="2026-04-16" status="scheduled">
<type code="REG" name="Regular Season"/>
</season>
<season id="4383ec83-6112-47f0-867a-8839145e1d58" year="2025" start_date="2025-09-20" end_date="2025-10-04" status="scheduled">
<type code="PRE" name="Pre-season"/>
</season> {
"id": "89d406e7-9d45-4e55-bdb3-5bf2a95b26d4",
"year": 2024,
"start_date": "2025-04-19",
"end_date": "2025-06-17",
"status": "closed",
"type": {
"code": "PST",
"name": "Post-season"
}
},
{
"id": "c5ca79d2-9e65-4987-84da-6f26237a47b3",
"year": 2024,
"start_date": "2024-10-04",
"end_date": "2025-04-17",
"status": "closed",
"type": {
"code": "REG",
"name": "Regular Season"
}
},
{
"id": "ca35f7b9-e22c-4e52-a3d6-50ae05e005bf",
"year": 2024,
"start_date": "2024-09-21",
"end_date": "2024-10-07",
"status": "closed",
"type": {
"code": "PRE",
"name": "Pre-season"
}
},
{
"id": "3c1bb21f-6523-4115-87ee-c8c16ed80421",
"year": 2025,
"start_date": "2026-04-18",
"status": "scheduled",
"type": {
"code": "PST",
"name": "Post-season"
}
},
{
"id": "4a67cca6-b450-45f9-91c6-48e92ac19069",
"year": 2025,
"start_date": "2025-10-07",
"end_date": "2026-04-16",
"status": "scheduled",
"type": {
"code": "REG",
"name": "Regular Season"
}
},
{
"id": "4383ec83-6112-47f0-867a-8839145e1d58",
"year": 2025,
"start_date": "2025-09-20",
"end_date": "2025-10-04",
"status": "scheduled",
"type": {
"code": "PRE",
"name": "Pre-season"
}
}Venue IDs
Each NHL venue will have its own unique identifier under venue.id. You can locate all active team venues in League Hierarchy, and each Game feed will include the venue ID for that matchup.
Venue IDs will not change once created.
<team id="44174b0c-0f24-11e2-8525-18a905767e44" name="Devils" market="New Jersey" alias="NJ" sr_id="sr:team:3704" founded="1974" owner="David Blitzer and Josh Harris" general_manager="Tom Fitzgerald" president="Jake Reynolds" mascot="NJ Devil" sponsor="RWJBarnabas Health" minorleague_affiliate="Utica Comets, Adirondack Thunder" reference="1">
<venue id="c970f791-c3bf-411e-89c6-952695afd414" name="Prudential Center" capacity="16514" address="25 Lafayette Street" city="Newark" state="NJ" zip="07102" country="USA" time_zone="US/Eastern" sr_id="sr:venue:6048">
<location lat="40.73380931921417" lng="-74.17104444444301"/>
</venue>{
"id": "44174b0c-0f24-11e2-8525-18a905767e44",
"name": "Devils",
"market": "New Jersey",
"alias": "NJ",
"sr_id": "sr:team:3704",
"founded": 1974,
"owner": "David Blitzer and Josh Harris",
"general_manager": "Tom Fitzgerald",
"president": "Jake Reynolds",
"mascot": "NJ Devil",
"sponsor": "RWJBarnabas Health",
"minorleague_affiliate": "Utica Comets, Adirondack Thunder",
"reference": "1",
"venue": {
"id": "c970f791-c3bf-411e-89c6-952695afd414",
"name": "Prudential Center",
"capacity": 16514,
"address": "25 Lafayette Street",
"city": "Newark",
"state": "NJ",
"zip": "07102",
"country": "USA",
"time_zone": "US/Eastern",
"sr_id": "sr:venue:6048",
"location": {
"lat": "40.73380931921417",
"lng": "-74.17104444444301"
}
},The Sportradar IDs will be consistent across sports and leagues, where available. Meaning those venue IDs would be consistent across APIs.
Updated 35 minutes ago