## NCAA Men's Hockey API Overview
Sportradar’s NCAAMH API offers scores and time remaining updates for all in-progress Division I hockey games. It is consistent in structure, format, and behavior with our other League Specific APIs.
Primary feeds will return schedules, standings, and game scores. Additional feeds provide complementary data, including team rosters and Top 25 rankings.
API
API Version
NCAA Men's Hockey
v3
Note: Authentication is required for all API calls.
## NCAA Men's Hockey API Map
To best utilize the NCAA Men's Hockey 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 home team's overtime score 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 overtime statistics and locate points
>The number of the home team's overtime points are 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 Tournament Ids which can be used to generate the game, team, and tournament feeds. All of the other feeds require no variables.
Note: Tournament Ids are only listed in the Tournament List feed. Use the Tournament List to get the Ids required to access the Tournament Schedule and Tournament Summary.
## Daily Change Log
Provides IDs and timestamps for teams, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
TTL / Cache:
300 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Point:
Id
League Data Points:
Alias Id
Name
Season Id
Player Data Points:
Full Name
Id
Team Data Points:
Id
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/league/2021/03/12/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", "/ncaamh/trial/v3/en/league/2021/03/12/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/ncaamh/trial/v3/en/league/2021/03/12/changes.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Change Log feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/league/`{year}`/`{month}`/`{day}`/changes.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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/ncaamh-`{access_level}{version}`/schema/changelog-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Daily Schedule
Date, time, location, and other event details for every match-up taking place in the league-defined day.
TTL / Cache:
10 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Alias Away Team Id Away Team Name Away Team Seed Number Broadcast Cable Broadcast Internet Broadcast Network Broadcast Radio Broadcast Satellite
Coverage Home Team Alias Home Team Id Home Team Name Home Team Seed Number Id Scheduled Date and Time Source Away Team
Source Coverage Source Home Team Source Id Source Outcome Source Scheduled Date and Time Source Status Source Title Status Title
League Data Points:
Alias
Id
Name
Venue Data Points:
Address Capacity City
Country Description Id
Name State Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/games/2021/10/09/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", "/ncaamh/trial/v3/en/games/2021/10/09/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/ncaamh/trial/v3/en/games/2021/10/09/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/games/`{year}`/`{month}`/`{day}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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.
https://api.sportradar.us/ncaamh-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Game Boxscore
Top-level team scores by period for a given game.
Update Frequency:
Live
TTL / Cache:
Live - 2s Non-Live - 120s
Note: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Content Type:
XML or JSON
Boxscore Data Points:
Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Overtime Score Away Team Period Score Away Team Shootout Score Clock
Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Overtime Score Home Team Period Score Home Team Shootout Score
Overtime Number Overtime Sequence Period Period Number Period Sequence Shootout Number Shootout Sequence
Game Data Points:
Away Team Id Coverage Home Team Id
Id Schedule Date And Time
Status Title
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/games/2e40adec-8ff1-47aa-9dc1-6a37d9483ee4/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", "/ncaamh/trial/v3/en/games/2e40adec-8ff1-47aa-9dc1-6a37d9483ee4/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/ncaamh/trial/v3/en/games/2e40adec-8ff1-47aa-9dc1-6a37d9483ee4/boxscore.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Game Boxscore feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/games/`{game_id}`/boxscore.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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/ncaamh-`{access_level}{version}`/schema/game-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## League Hierarchy
League, conference, division, and team identification and association information.
TTL / Cache:
300 seconds
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 Name
State Id Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/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", "/ncaamh/trial/v3/en/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/ncaamh/trial/v3/en/league/hierarchy.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the League Hierarchy feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/league/hierarchy.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `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/ncaamh-`{access_level}{version}`/schema/ncaamh/hierarchy-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Rankings
List by week of USCHO and USA Today/USA Hockey rankings, including those teams not ranked but receiving votes.
TTL / Cache:
2 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Poll Data Points:
Alias Effective Date First Place Votes Id
Name Points Rank
Votes Week Year
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/polls/USCHO/2021/W2/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", "/ncaamh/trial/v3/en/polls/USCHO/2021/W2/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/ncaamh/trial/v3/en/polls/USCHO/2021/W2/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Rankings feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/polls/`{poll_name}`/`{season_year}`/`{week}`/rankings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `poll_name` | Name of the poll: USCHO or USA. |
| `season_year` | Year in 4 digit format (YYYY). |
| `week` | Optional: Season week (i.e. W4 or W10). |
| `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/ncaamh-`{access_level}{version}`/schema/rankings-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Schedule
Date, time, location, and other event details for every match-up taking place in the full league season.
TTL / Cache:
10 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Alias Away Team Id Away Team Name Away Team Seed Number Broadcast Cable Broadcast Internet Broadcast Network Broadcast Radio Broadcast Satellite
Coverage Home Team Alias Home Team Id Home Team Name Home Team Seed Number Id Scheduled Date and Time Source Away Team
Source Coverage Source Home Team Source Id Source Outcome Source Scheduled Date and Time Source Status Source Title 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 Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/games/2021/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", "/ncaamh/trial/v3/en/games/2021/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/ncaamh/trial/v3/en/games/2021/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/games/`{season_year}`/`{ncaamh_season}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamh_season` | Conference Tournament (CT), 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/ncaamh-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Standings
Provides detailed standings info for a given season.
TTL / Cache:
120 seconds
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 Points Conference Ties Conference Winning Percentage Conference Wins Division Losses Division Ties Division Winning Percentage Division Wins Games Played Home Losses Home Ties Home Winning Percentage Home Wins
Last 10 Games Losses Last 10 Games Ties Last 10 Games Winning Percentage Last 10 Games Wins Last 10 Home Games Losses Last 10 Home Games Ties Last 10 Home Games Winning Percentage Last 10 Home Games Wins Last 10 Road Games Losses Last 10 Road Games Ties Last 10 Road Games Winning Percentage Last 10 Road Games Wins Overall Losses Overall Goal Differential
Overall Goals Against Overall Goals For Overall Ties Overall Winning Percentage Overall Wins Road Losses Road Ties Road Winning Percentage Road Wins Streak Versus * Losses Versus * Ties Versus * Winning Percentage Versus * Wins
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/seasontd/2021/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", "/ncaamh/trial/v3/en/seasontd/2021/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/ncaamh/trial/v3/en/seasontd/2021/REG/standings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Standings feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/seasons/`{season_year}`/`{ncaamh_season}`/standings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamh_season` | Conference Tournament (CT), 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/ncaamh-`{access_level}{version}`/schema/ncaamh/standings-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Team Profile (Rosters)
Detailed team information including a full player roster.
TTL / Cache:
300 seconds
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 Experience First Name Full Name
Handedness Height (in) High School Id Jersey Number
Last Name Position Primary Position Status 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 Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/teams/bfe11448-71a4-4757-8586-d6dec6bc271b/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", "/ncaamh/trial/v3/en/teams/bfe11448-71a4-4757-8586-d6dec6bc271b/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/ncaamh/trial/v3/en/teams/bfe11448-71a4-4757-8586-d6dec6bc271b/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Team Profile feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `team_id` | ID for 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/ncaamh-`{access_level}{version}`/schema/team-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Tournament List
Summarized list of all tournaments scheduled for the given season including tournament name, location, start date, and end date.
TTL / Cache:
2 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Alias Id
Name Season Id
Season Type Season Year
Tournament Data Points:
End Date Start Date
Status Id
Location Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/tournaments/2020/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", "/ncaamh/trial/v3/en/tournaments/2020/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/ncaamh/trial/v3/en/tournaments/2020/PST/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Tournament List feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/tournaments/`{season_year}`/`{ncaamh_season}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamh_season` | Conference Tournament (CT), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Tournaments List, replace the parameters in the following URL.
https://api.sportradar.us/ncaamh-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Tournament Schedule
Date, time, location, and other event details for every match-up taking place for a given tournament.
TTL / Cache:
2 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Alias Away Team Id Away Team Name Away Team Seed Number Broadcast Cable Broadcast Internet Broadcast Network Broadcast Radio Broadcast Satellite
Coverage Home Team Alias Home Team Id Home Team Name Home Team Seed Number Id Scheduled Date and Time Source Away Team
Source Coverage Source Home Team Source Id Source Outcome Source Scheduled Date and Time Source Status Source Title Status Title
League Data Points:
Alias
Id
Name
Tournament Data Points:
Bracket Description Bracket Id Bracket Location Bracket Name
Id Location Name Round Id
Round Name Round Sequence Status
Venue Data Points:
Address Capacity City
Country Description Id
Name State Zip
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/tournaments/b667a9d5-398e-42cd-ac3e-1f29ec305879/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", "/ncaamh/trial/v3/en/tournaments/b667a9d5-398e-42cd-ac3e-1f29ec305879/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/ncaamh/trial/v3/en/tournaments/b667a9d5-398e-42cd-ac3e-1f29ec305879/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Tournament Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/tournaments/`{tournament_id}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `tournament_id` | ID for a given tournament. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Tournaments Schedule, replace the parameters in the following URL.
https://api.sportradar.us/ncaamh-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## Tournament Summary (Seeded)
Tournament information including location, status, start date, end date, set up, and participants.
TTL / Cache:
2 seconds
Update Frequency:
As Necessary
Content Type:
XML or JSON
Tournament Data Points:
Bracket Description Bracket Id Bracket Location Bracket Name
End Date Id Location
Name Start Date Status
Team Data Points:
Id Market
Name
Tournament Seed
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamh/trial/v3/en/tournaments/b667a9d5-398e-42cd-ac3e-1f29ec305879/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", "/ncaamh/trial/v3/en/tournaments/b667a9d5-398e-42cd-ac3e-1f29ec305879/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/ncaamh/trial/v3/en/tournaments/b667a9d5-398e-42cd-ac3e-1f29ec305879/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Tournament Summary feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamh/`{access_level}`/`{version}`/en/tournaments/`{tournament_id}`/summary.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: 3). |
| `tournament_id` | ID for a given tournament. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Tournaments Summary, replace the parameters in the following URL.
https://api.sportradar.us/ncaamh-`{access_level}{version}`/schema/tournament-v2.0.xsd?api_key=`{your_api_key}`
Return to top
## 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 is the expected coverage level for NCAA men’s hockey?
A: We currently provide boxscore coverage for all division I college hockey games. We provide scores and time remaining in a timely manner as the game progresses.
Q: What are the Game statuses I can expect to see in the feeds and 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.
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.
Q: What are the player experience values I can expect to see in the feeds?
A: Here is a list of the valid player experience values and their definitions.
FR – Freshman
SO – Sophomore
JR – Junior
SR – Senior
GR – Graduate Student
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 – The player is on the team’s active roster.
NWT – The player is no longer with the team.
Q: What are the valid season types?
A: Here is a list of the valid season types and their definition:
REG – Regular season
CT – Conference tournaments
PST – Post-season
Q: How do I locate the TTL (Time to Live)/cache on an API endpoint?
A: The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.
ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120
Note that, for select game-centric endpoints, the TTL may adjust when an event is live. This information is available for each endpoint on our developer portal.