Note: Authentication is required for all API calls.
## NHL API Map
To best utilize the NHL API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
>
Examples:
>To find a players assists for a given game:
>
Call the schedule or daily schedule and find the Game Id for the chosen game
Call the Game Boxscore using the Game Id
Find the assists statistics and locate the player full_name
>The number of the players's assists is displayed.
>
>To find the coach's name for a given team:
>
Call the season or series schedule and find id for the coach's team
Call the Team Profile using the Team ID
Find the coach element and locate the full_name attribute
>The coach's full name is displayed.
The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.
Note: Series Ids are only listed in the Series Schedule feed. Use the Series Schedule to get the Ids required to access the Series Faceoffs and Series Statistics.
## Daily Change Log
Information on any changes made to teams, players, game statistics, and standings.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Id
Title
League Data Points:
Alias Id
Name
Season Id
Player Data Points:
Full Name
Id
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/league/2015/09/21/changes.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/league/2015/09/21/changes.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/league/2015/09/21/changes.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Daily Change Log.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/changes.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Daily Change Log, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/changelog-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Daily Schedule
Date, time, location, and other event details for every match-up taking place in the league defined day.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Rotation Number Away Team Seeding Broadcast Cable Broadcast Internet
Broadcast Network Broadcast Radio Broadcast Satellite Coverage Home Team Alias Home Team Id Home Team Name
Home Team Points Home Team Rotation Number Home Team Seeding Id Scheduled Date and Time Status Title
League Data Points:
Alias
Id
Name
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/2015/09/21/schedule.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/2015/09/21/schedule.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/2015/09/21/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
To access the Daily Schedule feed, replace the parameters in the following URL:
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{year}`/`{month}`/`{day}`/schedule.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, replace the parameters in the following URL.
http://api.sportradar.us/nhl-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Daily Transfers
Information for all transfers added or edited during the league defined day.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias
Id
Name
Player Data Points:
First Name Full Name Id Jersey Number Last Name Position Primary Position
Transfers Description Transfers Effective Date Transfers End Date Transfers Id Transfers New Team Id Transfers New Team Market Transfers New Team Name
Transfers Notes Transfers Old Team Id Transfers Old Team Market Transfers Old Team Name Transfers Start Date Transfers Update Date
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/league/2015/09/21/transfers.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/league/2015/09/21/transfers.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/league/2015/09/21/transfers.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Daily Transfers.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/transfers.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Daily Transfers, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/transfers-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Boxscore
Top-level team scores by quarter along with full statistics for each teams leaders in assists, goals, and points.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Boxscore Data Points:
Actual End Time Actual Start Time Attendance Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Period Score Duration (in game time) Clock Period Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Period Score
Overtime Number Overtime Sequence Period id Period Number Period Sequence Period Type Shootout Number Shootout Sequence Team Leader In Assists Dominant Hand Team Leader In Assists First Name Team Leader In Assists Full Name Team Leader In Assists Id Team Leader In Assists Jersey Number Team Leader In Assists Last Name Team Leader In Assists Position Team Leader In Assists Primary Position
Team Leader In Goals Dominant Hand Team Leader In Goals First Name Team Leader In Goals Full Name Team Leader In Goals Id Team Leader In Goals Jersey Number Team Leader In Goals Last Name Team Leader In Goals Position Team Leader In Goals Primary Position Team Leader In Points Dominant Hand Team Leader In Points First Name Team Leader In Points Full Name Team Leader In Points Id Team Leader In Points Jersey Number Team Leader In Points Last Name Team Leader In Points Position Team Leader In Points Primary Position
Game Data Points:
Away Team Id Coverage Entry Mode
Home Team Id Id Scheduled Date And Time
Status Title
Player Game Statistics Data Points:
Assists Average Time on Ice Blocked Attempts Blocked Shots Even Strength Assists Even Strength Faceoff Win Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Time on Ice Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goal Flag Giveaways
Goals Hits Missed Shots Overtime Goals Penalties Penalty Goals Penalty Minutes Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Power Play Assists Power Play Faceoff Win Pct Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goal Power Play Missed Shots Power Play Shots on Goal
Power Play Time on Ice Shifts Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Win Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Time on Ice Shots on Goal Takeaways Total Time on Ice
Player Period Statistics Data Points:
Assists Blocked Attempts Blocked Shots Even Strength Assists Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won
Giveaways Goals Hits Missed Shots Penalties Penalty Goals Penalty Minutes Penalty Missed Shots Penalty Shots on Goal Points Power Play Assists
Power Play Goals Power Play Missed Shots Power Play Shots on Goal Shifts Shooting Percentage Short Handed Assists Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Shots on Goal Takeaways
Player Data Points:
Dominant Hand First Name Full Name
Id Jersey Number Last Name
Position Primary Position
Stars Of The Game Data Points:
Player Full Name Player Id Player Jersey Number
Player Position Sequence Team Id
Team Market Team Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/139cbe99-4c04-438e-bd9a-a7abe928a502/boxscore.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/139cbe99-4c04-438e-bd9a-a7abe928a502/boxscore.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/139cbe99-4c04-438e-bd9a-a7abe928a502/boxscore.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Game Boxscore information for a specific game.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/boxscore.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Game Boxscore, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/game-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Faceoffs
Detailed face-off information for teams and players, including period, zone, and strength breakdowns for a given game.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Boxscore Data Points:
Actual End Time Actual Start Time Attendance Away Team Game Score Away Team Id Away Team Market
Away Team Name Duration (in game time) Clock Period Home Team Game Score Home Team Id
Home Team Market Home Team Name Period Id Period Number Period Sequence Period Type
Player Game Faceoff Data Points:
3v3 Faceoff Winning Pct 3v3 Faceoffs 3v3 Faceoffs Lost 3v3 Faceoffs Won 3v4 Faceoff Winning Pct 3v4 Faceoffs 3v4 Faceoffs Lost 3v4 Faceoffs Won 3v5 Faceoff Winning Pct 3v5 Faceoffs 3v5 Faceoffs Lost 3v5 Faceoffs Won 4v3 Faceoff Winning Pct 4v3 Faceoffs 4v3 Faceoffs Lost 4v3 Faceoffs Won 4v4 Faceoff Winning Pct 4v4 Faceoffs 4v4 Faceoffs Lost 4v4 Faceoffs Won 4v5 Faceoff Winning Pct 4v5 Faceoffs 4v5 Faceoffs Lost
4v5 Faceoffs Won 5v3 Faceoff Winning Pct 5v3 Faceoffs 5v3 Faceoffs Lost 5v3 Faceoffs Won 5v4 Faceoff Winning Pct 5v4 Faceoffs 5v4 Faceoffs Lost 5v4 Faceoffs Won 5v5 Faceoff Winning Pct 5v5 Faceoffs 5v5 Faceoffs Lost 5v5 Faceoffs Won Defensive Zone Faceoff Winning Pct Defensive Zone Faceoffs Defensive Zone Faceoffs Lost Defensive Zone Faceoffs Won Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Type
Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Neutral Zone Faceoff Winning Pct Neutral Zone Faceoffs Neutral Zone Faceoffs Lost Neutral Zone Faceoffs Won Offensive Zone Faceoff Winning Pct Offensive Zone Faceoffs Offensive Zone Faceoffs Lost Offensive Zone Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Type Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Type
Team Game Faceoff Data Points:
Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Faceoff Winning Percentage Faceoffs
Faceoffs Lost Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost
Power Play Faceoffs Won Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won
Player Period Faceoff Data Points:
Defensive Zone Faceoff Winning Pct Defensive Zone Faceoffs Defensive Zone Faceoffs Lost Defensive Zone Faceoffs Won Faceoff Winning Percentage Faceoffs
Faceoffs Lost Faceoffs Won Neutral Zone Faceoff Winning Pct Neutral Zone Faceoffs Neutral Zone Faceoffs Lost
Neutral Zone Faceoffs Won Offensive Zone Faceoff Winning Pct Offensive Zone Faceoffs Offensive Zone Faceoffs Lost Offensive Zone Faceoffs Won
Game Data Points:
Away Team Id Coverage Entry Mode
Home Team Id Id Scheduled Time And Date
Status Title
Player Data Points:
Full Name Id
Jersey Number
Position
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/139cbe99-4c04-438e-bd9a-a7abe928a502/faceoffs.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/139cbe99-4c04-438e-bd9a-a7abe928a502/faceoffs.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/139cbe99-4c04-438e-bd9a-a7abe928a502/faceoffs.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Game Faceoffs.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/faceoffs.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Game Faceoffs, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/faceoffs-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Play-By-Play
Detailed, real-time information on every team possession and game event.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Boxscore Data Points:
Actual End Time Actual Start Time
Attendance Duration (in game time)
Clock Period
Game Data Points:
Away Team Id Coverage Entry Mode
Home Team Id Id Scheduled Date And Time
Status Title
Play-By-Play Data Points:
Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Period Score Event Attribution Team Goal Event Attribution Team Id Event Attribution Team Market Event Attribution Team Name Event Clock Event Description Event Details Goal Zone Event Details Penalty Code Event Details Penalty Duration
Event Details Penalty Type Event Details Reason Event Details Shot Distance Event Details Shot Type Event Details Stoppage Type Event Id Event Location X Coordinate Event Location Y Coordinate Event Participants Player Full Name Event Participants Player Id Event Participants Player Jersey Number Event Participants Team Id Event Participants Team Market Event Participants Team Name
Event Type Event Zone Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Period Score Official Flag Period Id Period Number Period Sequence Updated Timestamp Wall Clock
Play Details Data Points:
Assist Strength Assist Zone Attempt Blocked Strength Attempt Blocked Zone Block Strength Block Zone Faceoffs Strength Faceoffs Win Flag Faceoffs Zone Giveaway Strength Giveaway Zone Hits Hittee Strength Hits Hittee Zone Hits Hitter Strength Hits Hitter Zone
Missed Shot Penalty Flag Missed Shot Shootout Flag Missed Shot Strength Missed Shot Zone Penalty Minutes Penalty Severity Penalty Strength Penalty Drawn Minutes Penalty Drawn Severity Penalty Drawn Strength Penalty Served Minutes Penalty Served Severity Penalty Served Strength Shot Awarded Flag
Shot Goal Flag Shot Penalty Flag Shot Shootout Flag Shot Strength Shot Zone Shot Against Awarded Flag Shot Against Goal Flag Shot Against Penalty Flag Shot Against Saved Flag Shot Against Shootout Flag Shot Against Strength Shot Against Zone Takeaway Strength Takeaway Zone
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/pbp.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/pbp.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/pbp.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Play-By-Play for a game.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/pbp.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Game Play-By-Play, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/pbp-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Summary
Top-level boxscore information along with detailed game stats at the team and player levels.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Boxscore Data Points:
Actual End Time Actual Start Time Attendance Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Period Score Duration (in game time) Clock Game Officials Assignment Game Officials Experience
Game Officials First Name Game Officials Full Name Game Officials Id Game Officials Last Name Game Officials Number Period Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Period Score
Lineups Played Lineups Scratched Lineups Starter Overtime Number Overtime Sequence Period Id Period Number Period Sequence Period Type Shootout Number Shootout Sequence
Game Data Points:
Away Team Id Coverage Entry Mode
Home Team Id Id Scheduled Date And Time
Status Title
Player Game Statistics Data Points:
Assists Average Time on Ice Blocked Attempts Blocked Shots Even Strength Assists Even Strength Faceoff Win Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Time on Ice Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goal Flag Giveaways
Goals Hits Missed Shots Overtime Goals Penalties Penalty Goals Penalty Minutes Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Power Play Assists Power Play Faceoff Win Pct Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals Power Play Missed Shots Power Play Shots on Goal
Power Play Time on Ice Shifts Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Win Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Time on Ice Shots on Goal Takeaways Total Time on Ice
Player Goaltending Game Statistics Data Points:
Credit Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Outcome Penalty Goals Against Penalty Save Percentage Penalty Saves
Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against
Shootout Save Percentage Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shutout
Team Game Statistics Data Points:
3v3 Goals 3v3 Shots on Goal 3v4 Goals 3v4 Shots on Goal 3v5 Goals 3v5 Shots on Goal 4v3 Goals 4v3 Opportunities 4v3 Shots on Goal 4v3 Time 4v4 Goals 4v4 Shots on Goal 4v5 Goals 4v5 Shots on Goal 5v3 Goals 5v3 Opportunities 5v3 Shots on Goal 5v3 Time 5v4 Goals 5v4 Opportunities 5v4 Shots on Goal 5v4 Time 5v5 Goals 5v5 Shots on Goal Assists Blocked Attempts
Blocked Shots Even Strength Assists Even Strength Faceoff Winning Percentage Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Type Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goal Flag Giveaways Goals Hits Missed Shots Overtime Goals Penalties Penalty Goals Penalty Minutes Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Power Play Assists Power Play Faceoff Winning Percentage
Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals Power Play Missed Shots Power Play Opportunities Power Play Shots on Goal Power Play Type Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Winning Percentage Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Type Shots on Goal Takeaways Team Penalties Team Penalty Minutes
Team Goaltending Statistics Data Points:
Credit Empty Net Even Strength Goals Against Empty Net Goals Against Empty Net Power Play Goals Against Empty Net Short Handed Goals Against Empty Net Shots Against Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Penalty Goals Against
Penalty Save Percentage Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against
Shootout Save Percentage Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shutout Total Goals Against Total Shots Against Total Time on Ice
Player Period Statistics Data Points:
Assists Blocked Attempts Blocked Shots Even Strength Assists Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won
Giveaways Goals Hits Missed Shots Penalties Penalty Goals Penalty Minutes Penalty Missed Shots Penalty Shots on Goal Points Power Play Assists
Power Play Goals Power Play Missed Shots Power Play Shots on Goal Shifts Shooting Percentage Short Handed Assists Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Shots on Goal Takeaways
Player Goaltending Period Data Points:
Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Penalty Goals Against Penalty Save Percentage
Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage
Saves Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against
Player Data Points:
Captain Flag Dominant Hand First Name Full Name Id
Injuries Comment Injuries Description Injuries Id Injuries Start Date Injuries Status
Injuries Update Date Jersey Number Last Name Position Primary Position
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/summary.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/summary.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Game Summary.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/summary.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Game Summary, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/game-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Time On Ice
Detailed face-off information for teams and players, including shift information, for a given game.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Boxscore Data Points:
Actual End Time Actual Start Time Attendance Away Team Game Score Away Team Id Away Team Market
Away Team Name Duration (in game time) Clock Period Home Team Game Score Home Team Id
Home Team Market Home Team Name Period Id Period Number Period Sequence Period Type
Game Data Points:
Away Team Id Coverage Entry Mode
Home Team Id Id Scheduled Date And Time
Status Title
Player Data Points:
Full Name Id
Jersey Number
Position
Player Time On Ice Game Data Points:
3v4 Time on Ice 3v5 Time on Ice 4v3 Time on Ice 4v5 Time on Ice 5v3 Time on Ice
5v4 Time on Ice Average Time on Ice Even Strength Time on Ice Power Play Time on Ice Power Play Type
Shifts Short Handed Time on Ice Short Handed Type Total Time on Ice
Player Time On Ice Period Data Points:
Average Time On Ice Even Strength Time On Ice Power Play Time On Ice Shifts
Shifts Duration Shifts End Time Shifts Number
Shifts Start Time Short Handed Time On Ice Total Time On Ice
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/time_on_ice.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/time_on_ice.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/df8ac1e6-c278-4160-9dc8-d59bf8d8ca2c/time_on_ice.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Time on Ice for a game.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/time_on_ice.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `game_id` | ID for a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Game Time On Ice, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/time-on-ice-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Injuries
Information concerning all active player injuries for all teams within the league.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias
Id
Name
Player Data Points:
First Name Full Name Id Injuries Comment Injuries Description
Injuries Id Injuries Start Date Injuries Status Injuries Update Date
Jersey Number Last Name Position Primary Position
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/league/injuries.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/league/injuries.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/league/injuries.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves player Injuries.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/league/injuries.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Injuries, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/injuries-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## League Hierarchy
League, conference, division, team identification, and association information.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias Conference Alias Conference Id
Conference Name Division Alias Division Id
Division Name Id Name
Team Data Points:
Alias Id
Market
Name
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/league/hierarchy.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/league/hierarchy.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/league/hierarchy.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the League Hierarchy.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/league/hierarchy.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for League Hierarchy, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/nhl/hierarchy-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## League Leaders - Goaltending
NHL leader information for various goaltending categories including full player seasonal statistics for each player in each category.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Season Id
Season Type
Season Year
Player Goaltending League Leader Data Points:
Category Name Category Type Games Played Goals Against Goals Against per Game Losses Overtime Losses Player Rank
Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Short Handed Goals Against Short Handed Save Percentage
Short Handed Saves Short Handed Shots Against Shots Against Shutouts Stat Category Tied Flag Wins
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Player Goaltending Seasonal Statistics Data Points:
Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against Average Goals Against per Game Losses Overtime Losses Penalty Goals Against Penalty Save Percentage
Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against Shootout Save Percentage
Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Wins
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/leaders/goaltending.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/seasontd/2015/REG/leaders/goaltending.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/leaders/goaltending.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the League Leaders for goaltending.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nhl_season}`/leaders/goaltending.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for League Leaders Goaltending, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/statistics-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## League Leaders - Skaters
NHL leader information for various skater categories including full player seasonal statistics for each player in each category.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Season Id
Season Type
Season Year
Player Skater League Leader Data Points:
Assists Category Name Category Type Faceoffs Won Game Winning Goals Games Played Goals Goals per Game
Player Rank Plus/Minus Points Points per Game Power Play Assists Power Play Goals Power Play Points Power Play Shots on Goal
Shootout Goals Short Handed Assists Short Handed Goals Short Handed Points Short Handed Shots on Goal Shots on Goal Stat Category Tied Flag
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Player Skater Seasonal Statistics Data Points:
Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Win Pct Even Strength Faceoff Winning Percentage Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Games Scratched Games Started Giveaways
Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Win Pct Power Play Faceoff Winning Percentage Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals
Power Play Missed Shots Power Play Points Power Play Shots on Goal Shifts Shifts per Game Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Win Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Total Time on Ice Total Time on Ice per Game
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/leaders/offense.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/seasontd/2015/REG/leaders/offense.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/leaders/offense.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the League Leaders for offense.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nhl_season}`/leaders/offense.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for League Leaders Skaters, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/statistics-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Player Profile
Detailed player information including a current look at the players statistics for the current season.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias Id
Name Season Id
Season Type Season Year
Player Data Points:
Abbreviated name Birth Date Birth Place College Dominant Hand Draft Pick Draft Round
Draft Team Draft Year Experience First Name Full Name Height (in) Id
Jersey Number Last Name Position Primary Position Status Update Date Weight (lbs)
Player Seasonal Statistics Data Points:
Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Win Pct Even Strength Faceoff Winning Percentage Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Games Scratched Games Started Giveaways
Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Win Pct Power Play Faceoff Winning Percentage Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals
Power Play Missed Shots Power Play Points Power Play Shots on Goal Shifts Shifts per Game Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Win Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Total Time on Ice Total Time on Ice per Game
Player Seasonal Goaltending Statistics Data Points:
Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against Average Goals Against per Game Losses Overtime Losses Penalty Goals Against Penalty Save Percentage
Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against Shootout Save Percentage
Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Wins
Team Data Points:
Alias Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/players/42a966db-0f24-11e2-8525-18a905767e44/profile.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/players/42a966db-0f24-11e2-8525-18a905767e44/profile.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/players/42a966db-0f24-11e2-8525-18a905767e44/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Player Profile.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/players/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `player_id` | ID for a given player. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Player Profile, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/profile-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Rankings
Conference and division rank for each team, including post season clinching status.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias Conference Alias Conference Id Conference Name
Division Alias Division Id Division Name Id
Name Season Id Season Type Season Year
Standings Data Points:
Conference Rank
Division Rank
Playoff Status
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/rankings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/seasontd/2015/REG/rankings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the current Rankings.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nhl_season}`/rankings.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Regular Season (REG). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Rankings, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/nhl/rankings-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Schedule
Date, time, location, and other event details for every match-up taking place in the full league season.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Rotation Number Away Team Seeding Broadcast Cable Broadcast Internet
Broadcast Network Broadcast Radio Broadcast Satellite Coverage Home Team Alias Home Team Id Home Team Name
Home Team Points Home Team Rotation Number Home Team Seeding Id Scheduled Date and Time Status Title
League Data Points:
Alias Id
Name Season Id
Season Type Season Year
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/games/2015/REG/schedule.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/games/2015/REG/schedule.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/games/2015/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Schedule.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/games/`{season_year}`/`{nhl_season}`/schedule.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Schedule, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Seasonal Faceoffs
Detailed face-off information for teams and players, including period, zone, and strength breakdowns for a given season.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Season Opponent Faceoff Data Points:
Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Faceoff Winning Percentage Faceoffs
Faceoffs Lost Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost
Power Play Faceoffs Won Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won
Season Player Faceoff Data Points:
3v3 Faceoff Winning Pct 3v3 Faceoffs 3v3 Faceoffs Lost 3v3 Faceoffs Won 3v4 Faceoff Winning Pct 3v4 Faceoffs 3v4 Faceoffs Lost 3v4 Faceoffs Won 3v5 Faceoff Winning Pct 3v5 Faceoffs 3v5 Faceoffs Lost 3v5 Faceoffs Won 4v3 Faceoff Winning Pct 4v3 Faceoffs 4v3 Faceoffs Lost 4v3 Faceoffs Won 4v4 Faceoff Winning Pct 4v4 Faceoffs 4v4 Faceoffs Lost 4v4 Faceoffs Won 4v5 Faceoff Winning Pct 4v5 Faceoffs 4v5 Faceoffs Lost
4v5 Faceoffs Won 5v3 Faceoff Winning Pct 5v3 Faceoffs 5v3 Faceoffs Lost 5v3 Faceoffs Won 5v4 Faceoff Winning Pct 5v4 Faceoffs 5v4 Faceoffs Lost 5v4 Faceoffs Won 5v5 Faceoff Winning Pct 5v5 Faceoffs 5v5 Faceoffs Lost 5v5 Faceoffs Won Defensive Zone Faceoff Winning Pct Defensive Zone Faceoffs Defensive Zone Faceoffs Lost Defensive Zone Faceoffs Won Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Type
Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Neutral Zone Faceoff Winning Pct Neutral Zone Faceoffs Neutral Zone Faceoffs Lost Neutral Zone Faceoffs Won Offensive Zone Faceoff Winning Pct Offensive Zone Faceoffs Offensive Zone Faceoffs Lost Offensive Zone Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Type Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Type
Season Team Faceoff Data Points:
Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Faceoff Winning Percentage Faceoffs
Faceoffs Lost Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost
Power Play Faceoffs Won Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won
League Data Points:
Season Id
Season Type
Season Year
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/seasontd/2013/REG/teams/44151f7a-0f24-11e2-8525-18a905767e44/faceoffs.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/seasontd/2013/REG/teams/44151f7a-0f24-11e2-8525-18a905767e44/faceoffs.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/seasontd/2013/REG/teams/44151f7a-0f24-11e2-8525-18a905767e44/faceoffs.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Seasonal Faceoffs.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nhl_season}`/teams/`{team_id}`/faceoffs.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Regular Season (REG), or Postseason (PST). |
| `team_id` | ID of a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Seasonal Faceoffs, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/faceoffs-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Seasonal Statistics (Season To Date)
Detailed team and player statistics for the defined season to the current date.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Season Id
Season Type
Season Year
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Opponent Seasonal Statistics Data Points:
3v3 Goals 3v3 Shots on Goal 3v4 Goals 3v4 Shots on Goal 3v5 Goals 3v5 Shots on Goal 4v3 Goals 4v3 Opportunities 4v3 Shots on Goal 4v4 Goals 4v4 Shots on Goal 4v5 Goals 4v5 Shots on Goal 5v3 Goals 5v3 Opportunities 5v3 Shots on Goal 5v4 Goals 5v4 Opportunities 5v4 Shots on Goal 5v5 Goals 5v5 Shots on Goal Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Winning Percentage Even Strength Faceoffs
Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Type Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Giveaways Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Winning Percentage
Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals Power Play Missed Shots Power Play Opportunities Power Play Shots on Goal Power Play Type Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Winning Percentage Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Type Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Team Penalties Team Penalties per Game Team Penalty Minutes Team Penalty Minutes per Game
Opponent Goaltending Seasonal Statistics Data Points:
Empty Net Even Strength Goals Against Empty Net Goals Against Empty Net Power Play Goals Against Empty Net Short Handed Goals Against Empty Net Shots Against Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against per Game Losses Overtime Losses
Penalty Goals Against Penalty Save Percentage Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against
Shootout Save Percentage Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Total Goals Against Total Shots Against Total Time on Ice Wins
Player Seasonal Statistics Data Points:
Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Win Pct Even Strength Faceoff Winning Percentage Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Games Scratched Games Started Giveaways
Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Win Pct Power Play Faceoff Winning Percentage Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals
Power Play Missed Shots Power Play Points Power Play Shots on Goal Shifts Shifts per Game Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Win Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Total Time on Ice Total Time on Ice per Game
Player Goaltending Seasonal Statistics Data Points:
Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against Average Goals Against per Game Losses Overtime Losses Penalty Goals Against Penalty Save Percentage
Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against Shootout Save Percentage
Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Wins
Team Season Statistics Data Points:
3v3 Goals 3v3 Shots on Goal 3v4 Goals 3v4 Shots on Goal 3v5 Goals 3v5 Shots on Goal 4v3 Goals 4v3 Opportunities 4v3 Shots on Goal 4v4 Goals 4v4 Shots on Goal 4v5 Goals 4v5 Shots on Goal 5v3 Goals 5v3 Opportunities 5v3 Shots on Goal 5v4 Goals 5v4 Opportunities 5v4 Shots on Goal 5v5 Goals 5v5 Shots on Goal Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Winning Percentage Even Strength Faceoffs
Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Type Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Giveaways Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Winning Percentage
Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals Power Play Missed Shots Power Play Opportunities Power Play Shots on Goal Power Play Type Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Winning Percentage Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Type Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Team Penalties Team Penalties per Game Team Penalty Minutes Team Penalty Minutes per Game
Team Goaltending Seasonal Statistics Data Points:
Empty Net Even Strength Goals Against Empty Net Goals Against Empty Net Power Play Goals Against Empty Net Short Handed Goals Against Empty Net Shots Against Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against per Game Losses Overtime Losses
Penalty Goals Against Penalty Save Percentage Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against
Shootout Save Percentage Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Total Goals Against Total Shots Against Total Time on Ice Wins
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/teams/4416091c-0f24-11e2-8525-18a905767e44/statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/seasontd/2015/REG/teams/4416091c-0f24-11e2-8525-18a905767e44/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/teams/4416091c-0f24-11e2-8525-18a905767e44/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Seasonal Statistics for a given team.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nhl_season}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Regular Season (REG), or Postseason (PST). |
| `team_id` | ID of a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Seasonal Statistics, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/statistics-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Series Faceoffs
Detailed face-off information for teams and players, including period, zone, and strength breakdowns for a given series.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Series Opponent Faceoff Data Points:
Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Faceoff Winning Percentage Faceoffs
Faceoffs Lost Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost
Power Play Faceoffs Won Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won
Series Player Faceoff Data Points:
3v3 Faceoff Winning Pct 3v3 Faceoffs 3v3 Faceoffs Lost 3v3 Faceoffs Won 3v4 Faceoff Winning Pct 3v4 Faceoffs 3v4 Faceoffs Lost 3v4 Faceoffs Won 3v5 Faceoff Winning Pct 3v5 Faceoffs 3v5 Faceoffs Lost 3v5 Faceoffs Won 4v3 Faceoff Winning Pct 4v3 Faceoffs 4v3 Faceoffs Lost 4v3 Faceoffs Won 4v4 Faceoff Winning Pct 4v4 Faceoffs 4v4 Faceoffs Lost 4v4 Faceoffs Won 4v5 Faceoff Winning Pct 4v5 Faceoffs 4v5 Faceoffs Lost
4v5 Faceoffs Won 5v3 Faceoff Winning Pct 5v3 Faceoffs 5v3 Faceoffs Lost 5v3 Faceoffs Won 5v4 Faceoff Winning Pct 5v4 Faceoffs 5v4 Faceoffs Lost 5v4 Faceoffs Won 5v5 Faceoff Winning Pct 5v5 Faceoffs 5v5 Faceoffs Lost 5v5 Faceoffs Won Defensive Zone Faceoff Winning Pct Defensive Zone Faceoffs Defensive Zone Faceoffs Lost Defensive Zone Faceoffs Won Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Type
Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Neutral Zone Faceoff Winning Pct Neutral Zone Faceoffs Neutral Zone Faceoffs Lost Neutral Zone Faceoffs Won Offensive Zone Faceoff Winning Pct Offensive Zone Faceoffs Offensive Zone Faceoffs Lost Offensive Zone Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Type Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Type
Series Team Faceoff Data Points:
Even Strength Faceoff Winning Pct Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Faceoff Winning Percentage Faceoffs
Faceoffs Lost Faceoffs Won Power Play Faceoff Winning Pct Power Play Faceoffs Power Play Faceoffs Lost
Power Play Faceoffs Won Short Handed Faceoff Winning Pct Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Series Data Points:
Id
Status
Title
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/series/06edf786-07a9-4ff2-a9af-138ec916cce6/teams/441781b9-0f24-11e2-8525-18a905767e44/faceoffs.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/series/06edf786-07a9-4ff2-a9af-138ec916cce6/teams/441781b9-0f24-11e2-8525-18a905767e44/faceoffs.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/series/06edf786-07a9-4ff2-a9af-138ec916cce6/teams/441781b9-0f24-11e2-8525-18a905767e44/faceoffs.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Series Faceoffs.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/series/`{series_id}`/teams/`{team_id}`/faceoffs.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `series_id` | ID of a given series. |
| `team_id` | ID of a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Series Faceoffs, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/faceoffs-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Series Schedule
Play-off participant information as well as the date, time, location, and other event details for every match-up taking place for the entire play-offs.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Rotation Number Away Team Seeding Broadcast Cable Broadcast Internet
Broadcast Network Broadcast Radio Broadcast Satellite Coverage Home Team Alias Home Team Id Home Team Name
Home Team Points Home Team Rotation Number Home Team Seeding Id Scheduled Date and Time Status Title
League Data Points:
Alias Id
Name Season Id
Season Type Season Year
Series Data Points:
Id Participant Name Participant Record Participant Seed
Round Source Game Id Source Game Title Source Outcome
Source Round Start Date Status Title
Team Data Points:
Alias Id
Market
Name
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/series/2015/PST/schedule.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/series/2015/PST/schedule.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/series/2015/PST/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Series Schedule.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/series/`{season_year}`/`{nhl_season}`/schedule.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Series Schedule, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Series Statistics
Detailed team and player statistics for the defined series.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Series Data Points:
Id
Status
Title
Opponent Series Statistics Data Points:
3v3 Goals 3v3 Shots on Goal 3v4 Goals 3v4 Shots on Goal 3v5 Goals 3v5 Shots on Goal 4v3 Goals 4v3 Opportunities 4v3 Shots on Goal 4v4 Goals 4v4 Shots on Goal 4v5 Goals 4v5 Shots on Goal 5v3 Goals 5v3 Opportunities 5v3 Shots on Goal 5v4 Goals 5v4 Opportunities 5v4 Shots on Goal 5v5 Goals 5v5 Shots on Goal Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Winning Percentage Even Strength Faceoffs
Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Type Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Giveaways Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Winning Percentage
Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals Power Play Missed Shots Power Play Opportunities Power Play Shots on Goal Power Play Type Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Winning Percentage Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Type Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Team Penalties Team Penalties per Game Team Penalty Minutes Team Penalty Minutes per Game
Opponent Goaltending Series Statistics Data Points:
Empty Net Even Strength Goals Against Empty Net Goals Against Empty Net Power Play Goals Against Empty Net Short Handed Goals Against Empty Net Shots Against Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against per Game Losses Overtime Losses
Penalty Goals Against Penalty Save Percentage Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against
Shootout Save Percentage Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Total Goals Against Total Shots Against Total Time on Ice Wins
Player Series Statistics Data Points:
Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Winning Percentage Even Strength Faceoffs Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Games Scratched Games Started Giveaways
Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Winning Percentage Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals
Power Play Missed Shots Power Play Shots on Goal Shifts Shifts per Game Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Winning Percentage Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Total Time on Ice Total Time on Ice per Game
Player Goaltending Series Statistics Data Points:
Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against Average Goals Against per Game Losses Overtime Losses Penalty Goals Against Penalty Save Percentage
Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against Shootout Save Percentage
Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Wins
Team Series Statistics Data Points:
3v3 Goals 3v3 Shots on Goal 3v4 Goals 3v4 Shots on Goal 3v5 Goals 3v5 Shots on Goal 4v3 Goals 4v3 Opportunities 4v3 Shots on Goal 4v4 Goals 4v4 Shots on Goal 4v5 Goals 4v5 Shots on Goal 5v3 Goals 5v3 Opportunities 5v3 Shots on Goal 5v4 Goals 5v4 Opportunities 5v4 Shots on Goal 5v5 Goals 5v5 Shots on Goal Assists Assists per Game Blocked Attempts Blocked Attempts per Game Blocked Shots Blocked Shots per Game Even Strength Assists Even Strength Faceoff Winning Percentage Even Strength Faceoffs
Even Strength Faceoffs Lost Even Strength Faceoffs Won Even Strength Goals Even Strength Missed Shots Even Strength Shots on Goal Even Strength Type Faceoff Winning Percentage Faceoffs Faceoffs Lost Faceoffs Won Game Winning Goals Games Played Giveaways Giveaways per Game Goals Goals per Game Hits Hits per Game Missed Shots Missed Shots per Game Overtime Goals Penalties Penalties per Game Penalty Goals Penalty Minutes Penalty Minutes per Game Penalty Missed Shots Penalty Shots on Goal Plus/Minus Points Points per Game Power Play Assists Power Play Faceoff Winning Percentage
Power Play Faceoffs Power Play Faceoffs Lost Power Play Faceoffs Won Power Play Goals Power Play Missed Shots Power Play Opportunities Power Play Shots on Goal Power Play Type Shooting Percentage Shootout Goals Shootout Missed Shots Shootout Shots on Goal Short Handed Assists Short Handed Faceoff Winning Percentage Short Handed Faceoffs Short Handed Faceoffs Lost Short Handed Faceoffs Won Short Handed Goals Short Handed Missed Shots Short Handed Shots on Goal Short Handed Type Shots on Goal Shots on Goal per Game Takeaways Takeaways per Game Team Penalties Team Penalties per Game Team Penalty Minutes Team Penalty Minutes per Game
Team Goaltending Series Statistics Data Points:
Empty Net Even Strength Goals Against Empty Net Goals Against Empty Net Power Play Goals Against Empty Net Short Handed Goals Against Empty Net Shots Against Even Strength Goals Against Even Strength Save Percentage Even Strength Saves Even Strength Shots Against Goals Against Goals Against per Game Losses Overtime Losses
Penalty Goals Against Penalty Save Percentage Penalty Saves Penalty Shots Against Power Play Goals Against Power Play Save Percentage Power Play Saves Power Play Shots Against Save Percentage Saves Shootout Goals Against
Shootout Save Percentage Shootout Saves Shootout Shots Against Short Handed Goals Against Short Handed Save Percentage Short Handed Saves Short Handed Shots Against Shots Against Shots Against per Game Shutouts Total Goals Against Total Shots Against Total Time on Ice Wins
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/series/06edf786-07a9-4ff2-a9af-138ec916cce6/teams/441781b9-0f24-11e2-8525-18a905767e44/statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/series/06edf786-07a9-4ff2-a9af-138ec916cce6/teams/441781b9-0f24-11e2-8525-18a905767e44/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/series/06edf786-07a9-4ff2-a9af-138ec916cce6/teams/441781b9-0f24-11e2-8525-18a905767e44/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the current Series Statistics.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/series/`{series_id}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `series_id` | ID of a given series. |
| `team_id` | ID of a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Series Statistics, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/statistics-v3.0.xsd?api_key=`{your_api_key}`
Return to API map
## Standings
Detailed team records across various views including, overall, conference, and division information.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias Conference Alias Conference Id Conference Name
Division Alias Division Id Division Name Id
Name Season Id Season Type Season Year
Standings Data Points:
Conference Losses Conference Overtime Losses Conference Winning Percentage Conference Wins Division Losses Division Overtime Losses Division Winning Percentage Division Wins Games Played Goal Differential Goals Against Goals For Home Losses Home Overtime Losses Home Winning Percentage Home Wins Last 10 Games Losses Last 10 Games Overtime Losses Last 10 Games Winning Percentage Last 10 Games Wins Last 10 Home Games Losses
Last 10 Home Games Overtime Losses Last 10 Home Games Winning Percentage Last 10 Home Games Wins Last 10 Road Games Losses Last 10 Road Games Overtime Losses Last 10 Road Games Winning Percentage Last 10 Road Games Wins Losses Overtime Losses Penalty Killing Percentage Points Power Play Goals Power Play Goals Against Power Play Opportunities Power Play Percentage Power Plays Against Regulation Wins Road Losses Road Overtime Losses Road Winning Percentage Road Wins
Shootout Losses Shootout Wins Streak Versus Atlantic Division Losses Versus Atlantic Division Overtime Losses Versus Atlantic Division Winning Percentage Versus Atlantic Division Wins Versus Central Division Losses Versus Central Division Overtime Losses Versus Central Division Winning Percentage Versus Central Division Wins Versus Metropolitan Division Losses Versus Metropolitan Division Overtime Losses Versus Metropolitan Division Winning Percentage Versus Metropolitan Division Wins Versus Pacific Division Losses Versus Pacific Division Overtime Losses Versus Pacific Division Winning Percentage Versus Pacific Division Wins Winning Percentage Wins
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/standings.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/seasontd/2015/REG/standings.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/seasontd/2015/REG/standings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the current Standings.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nhl_season}`/standings.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `season_year` | Year in 4 digit format (YYYY). |
| `nhl_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Standings, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/nhl/standings-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Team Profile (Rosters)
Detailed team information including league affiliation information as well as player roster information.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias Conference Alias Conference Id
Conference Name Division Alias Division Id
Division Name Id Name
Player Data Points:
Abbreviated name Birth Date Birth Place College Dominant Hand Draft Pick Draft Round Draft Team Draft Year
Experience First Name Full Name Height (in) Id Injuries Comment Injuries Description Injuries Id Injuries Start Date
Injuries Status Injuries Update Date Jersey Number Last Name Position Primary Position Status Update Date Weight (lbs)
Team Data Points:
Alias Coach Experience Coach First Name Coach Full Name
Coach Id Coach Last Name Coach Position Id
Market Name Year Founded
Venue Data Points:
Address Capacity City Country
Description Id Name
State Timezone Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-ot4/teams/4416091c-0f24-11e2-8525-18a905767e44/profile.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nhl-ot4/teams/4416091c-0f24-11e2-8525-18a905767e44/profile.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-ot4/teams/4416091c-0f24-11e2-8525-18a905767e44/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Team Profile.
https://api.sportradar.us/nhl-`{access_level}{version}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (o) or Trial (ot). |
| `version` | Version number of the API you are accessing (Current Version: 4). |
| `language_code` | Optional 2 letter code for supported languages: ru (Russian) and zh (simplified Chinese). |
| `team_id` | ID of a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Team Profile, replace the parameters in the following URL.
https://api.sportradar.us/nhl-`{access_level}{version}`/schema/team-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Frequently Asked Questions
Q: What format are date fields presented in?
A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What format are the date/time fields presented in?
A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What game statuses I can expect to see in the feeds and what are their definitions?
A: Here is a list of the valid game statuses you can expect to see, and their definitions.
scheduled - The game is scheduled to occur.
created - The game has been created and we have begun logging information for the game.
inprogress – The game is in progress.
complete – The game is over, but stat validation is not complete.
closed – The game is over and the stats have been validated.
cancelled – The game has been cancelled. No makeup game will be played as a result.
delayed – The start of the game is currently delayed or the game has gone from in progress to delayed for some reason.
postponed – The game has been postponed, to be made up at another day and time. Once the makeup game is announced, a new game and ID will be created and scheduled on the announced makeup date. You should request the scheduled feed(s) regularly to identify the re-scheduled makeup game(s).
time-tbd – The game has been scheduled, but a time has yet to be announced.
if necessary – The game will be scheduled if it is required.
unnecessary – The series game was scheduled to occur, but will not take place due to one team clinching the series early.
Q: What are the valid events types tracked in the play by play feed?
A: Here is a list of the valid event types you can expect to see.
challenge
emptynetgoal
endperiod
endshootoutperiod
evenstrength
faceoff
gamesetup
giveaway
goal
goaliechange
hit
penalty
penaltygoal
penaltyshotmissed
penaltyshotsaved
powerplay
shootoutgoal
shootoutshotmissed
shootoutshotsaved
shotmissed
shotsaved
startshootoutperiod
stoppage
substitutions
takeaway
The following event types can be classified as stoppage, but will be classified in the event description:
teamtimeout
tvtimeout
Q: What are the Series statuses I can expect to see in the feeds and their definitions?
A: Here is a list of the valid series statuses you can expect to see, and their definitions.
scheduled - The series is scheduled to occur.
inprogress – The series is in progress.
closed – The series is over.
Q: What are the player positions I can expect to see in the feeds?
A: Here is a list of the valid player positions you can expect to see.
NA
D
F
F-D
G
Q: What are the player primary positions I can expect to see in the feeds?
A: Here is a list of the valid player primary positions you can expect to see.
NA
C
D
G
LW
RW
Q: What are the player statuses I can expect to see in the feeds?
A: Here is a list of the valid player statuses you can expect to see.
ACT – Active
IR – Injured reserve
M-LEAGUE – Sent to minor league team
NWT – Not with team
SUS – Suspended
Q: What are the player injury statuses I can expect to see in the feeds?
A: Here is a list of the valid player injury statuses you can expect to see.
Unknown
Day To Day
Out
Out For Season
Out Indefinitely
Q: What are the valid playoff statuses and their definitions?
A: Here is a list of the valid playoff statuses and their definitions:
conference – The team has the conference.
division – The team has clinched the division.
playoff_spot – The team has clinched a playoff berth.
presidents_trophy – Team has clinched the best record and home ice advantage.
Q: Do you provide your feeds in any languages other than English?
A: Currently, we provide our feeds in 3 languages: English, Russian, and Simplified Chinese. The codes are as follows:
English = eu
Russian = ru
Simplified Chinese = zh
Please note, our translated feeds include translated teams, players, play by play descriptions. The feeds themselves are in English, but the content of the attributes has been translated.
Q: What is the scale of the X/Y coordinates?
A: The rink we use is 2400 by 1020. The scale is in inches. Here is a layout of the rink:
Q. How will the competitive format change for the NHL this season?
A. We have outlined how the format will be affected below:
Regular Season
The 2019 regular season is complete. All unplayed games have been cancelled. Standings and statistics are final. All playoff clinching information has been updated.
Playoffs
The following key changes have been made to the playoff format:
Playoffs will now include 24 teams as opposed to the standard 16 teams.
12 teams from each conference will make the playoffs.
Playoffs will occur in 2 hub cities - The Eastern Conference will play in Toronto for the qualifying, first and second round, while the Western Conference will play in Edmonton. The Conference Finals and Stanley Cup Finals will be hosted in Edmonton.
There will be an extra round of the playoffs. This will be the Qualifying Round.
The top 4 teams in each conference will have a bye into the first round of the playoffs. During the qualifying round, they will play a round robin style tournament for seeding in the first round. Each team will play the other teams in round robin once. If these games go to overtime, they will be played under regular season overtime rules.
This round robin will be used to establish seeding going forward in the playoffs.
The bottom 8 teams will play a head to head series during the qualifying round. The winners will face one of the top 4 teams in the first round. These serieses will be best of 5. If games in these series go to overtime, they will be played under playoff overtime rules.
The playoffs will be re-seeded after each round. The highest remaining seed in each conference will face the lowest remaining seed, the second-highest remaining seed in each conference will face the second-lowest remaining seed.
All statistics in the qualifying round will count. For record keeping purposes, every team and player participating in the qualifying round will be considered to have made the playoffs.
Q. What changes do we need to plan for?
A. There will be no changes to most data feeds and functionality, the changes are isolated to the Series Schedule feed, with minor changes to the Daily Schedule and Schedule feeds as outlined below.
Q. What effect do these changes have on the NHL APIs?
A. Listed below are the changes to feed behavior:
The participant, home, and away seed values will now be 1-12 (instead of 1-8). This applies to all Schedule feeds.
There will now be 5 rounds of playoffs. The “Qualifying Round” will be classified as round 0 and the Stanley Cup Final will be classified as round 4. This applies only to the Series Schedule feed.
The Qualifying - Round Robin will contain 4 teams instead of 2. For this, the ‘record’ attribute will still populate indicating wins and the value will technically be correct, but it will be irrelevant since the NHL is using regular season OT rules. This applies only to the Series Schedule feed.
The seed attribute in the division element will be unpopulated. It is irrelevant with the new format. See "division" sample below. This applies only to the Series Schedule feed.
The following source elements and attributes will not be used in the feed (See "source" sample below), and only applies to the Series Schedule feed:
Q. What are the critical dates for the rest of 2020?
A. A selection of upcoming and updated critical dates are included below:
## Daily Change Log
Information on any changes made to teams, players, game statistics, and standings.
