NCAAMH FAQs

Coverage

What is the expected coverage level for NCAA men’s hockey?

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.

Integration

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

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

The TTL may adjust when an event is live for some game-centric endpoints. This information is available for each endpoint on our developer portal.

Game Statuses

What are the valid game statuses?

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.

Player Statuses

What are the player statuses?

ACT – The player is on the team’s active roster.
NWT – The player is no longer with the team.

What are the valid player experience values?

FR – Freshman
SO – Sophomore
JR – Junior
SR – Senior
GR – Graduate Student

Season Types

What are the valid season types?

REG – Regular season
CT – Conference tournaments
PST – Post-season

Schedules

How do I pull in schedule data for future games in which teams are not yet known?

This API features a TBD team used for every entry in to-be-determined matchups. This virtual team will have its own unique ID specific to this API.

Find the TBD team in the Teams endpoint.

<team id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" name="TBD" alias="TBD" market="Team"/>

The matchups will appear as below in the Schedule endpoints.

<series id="0f81bb4d-1d0c-4a3b-82de-507534154095" title="NBA Finals - TBD vs TBD" round="4" start_date="2024-06-06" status="scheduled">
  <games>
  <game id="342f103b-0fd7-47ac-a84d-1391e3605e96" status="time-tbd" title="Game 1" coverage="full" scheduled="2024-06-06T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  <game id="71d8d5fc-6836-43c1-85a0-61a828296a06" status="time-tbd" title="Game 2" coverage="full" scheduled="2024-06-09T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  <game id="50b170b9-37e2-47d0-b517-e56ebb960cba" status="time-tbd" title="Game 3" coverage="full" scheduled="2024-06-12T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  <game id="8e94445c-c223-4a49-a759-0b651e440b95" status="time-tbd" title="Game 4" coverage="full" scheduled="2024-06-14T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  <game id="aaa3ddb3-dd1b-459e-a686-d2bfc4408881" status="if-necessary" title="Game 5 (if necessary)" coverage="full" scheduled="2024-06-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  <game id="7c16f1ec-6629-4675-aaaa-2a31835862a6" status="if-necessary" title="Game 6 (if necessary)" coverage="full" scheduled="2024-06-20T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  <game id="09129676-2320-4151-976d-713ea785d97b" status="if-necessary" title="Game 7 (if necessary)" coverage="full" scheduled="2024-06-23T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </away>
  </game>
  </games>
</series>

{
  "series": [
    {
      "id": "0f81bb4d-1d0c-4a3b-82de-507534154095",
      "title": "NBA Finals - TBD vs TBD",
      "round": 4,
      "start_date": "2024-06-06",
      "status": "scheduled",
      "participants": [],
      "games": [
        {
          "id": "342f103b-0fd7-47ac-a84d-1391e3605e96",
          "status": "time-tbd",
          "title": "Game 1",
          "coverage": "full",
          "scheduled": "2024-06-06T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          }
        },
        {
          "id": "71d8d5fc-6836-43c1-85a0-61a828296a06",
          "status": "time-tbd",
          "title": "Game 2",
          "coverage": "full",
          "scheduled": "2024-06-09T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          }
        },
        {
          "id": "50b170b9-37e2-47d0-b517-e56ebb960cba",
          "status": "time-tbd",
          "title": "Game 3",
          "coverage": "full",
          "scheduled": "2024-06-12T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          }
        },
        {
          "id": "8e94445c-c223-4a49-a759-0b651e440b95",
          "status": "time-tbd",
          "title": "Game 4",
          "coverage": "full",
          "scheduled": "2024-06-14T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          }
        },
        {
          "id": "aaa3ddb3-dd1b-459e-a686-d2bfc4408881",
          "status": "if-necessary",
          "title": "Game 5 (if necessary)",
          "coverage": "full",
          "scheduled": "2024-06-17T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          }
        },
        {
          "id": "7c16f1ec-6629-4675-aaaa-2a31835862a6",
          "status": "if-necessary",
          "title": "Game 6 (if necessary)",
          "coverage": "full",
          "scheduled": "2024-06-20T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          }
        },
        {
          "id": "09129676-2320-4151-976d-713ea785d97b",
          "status": "if-necessary",
          "title": "Game 7 (if necessary)",
          "coverage": "full",
          "scheduled": "2024-06-23T17:00:00+00:00",
          "neutral_site": false,
          "track_on_court": true,
          "home": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
          },
          "away": {
            "name": "Team TBD",
            "alias": "TBD",
            "id": "907dc4e5-695

Categories