NCAA Mens Hockey v3

Frequently Asked Questions
Quick Access
Postman Collection XSD Schema
Download
## 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: >
  1. Call the schedule or daily schedule and find the Game Id for the chosen game
  2. Call the Game Boxscore using the Game Id
  3. 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: >
    1. Call the season or series schedule and find id for the coach's team
    2. Call the Team Profile using the Team ID
    3. 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.

    Return to top

    Docs Navigation