Schedules
Pull and display NHL schedule information
Prerequisite: Confirm Season Availability and Coverage
Understanding which seasons are available, and what level of data coverage is provided, is essential for making reliable and accurate API calls.
- Use the Seasons feed to view all available seasons in the API.
- Reference the
coveragenode in a schedule or game endpoint before a game to determine its level of coverage.
Starting Year for Each SeasonIt's important to note that the
season_yearparameter uses the starting year of the season; for example, to retrieve data for the 2024-25 NHL season, you would use2024as the value for the season parameter.
Scheduling Releases
The NHL schedule is typically released in mid-July. Preseason games begin in late September, followed by the regular season in early October. The postseason (Stanley Cup Playoffs) starts in mid-April, with match-ups determined at the conclusion of the regular season.
Releases may differ year-to-year depending on seasonal demands. You can also review the Update Frequencies page and the Data Entry Workflow for an overview of typical data updates during the season.
Scheduling Feeds Available
Accessing the schedule is fundamental to your integration and essential in critical scenarios. For instance, if you need to retrieve live game data, you'll first need to pull a schedule feed to obtain the event IDs for the specific matches you're targeting.
You can access NHL scheduling data using the following feeds:
- Daily Schedule - Provides date, time, location, and other event details for every match-up taking place in the league defined day.
- Schedule - Provides date, time, location, and other event details for every match-up taking place in the full league season.
- Series Schedule - Provides playoff participant information and the date, time, location, and other event details for every match-up taking place for the entire playoffs.
Use the Update Frequencies PageFor recommended pull intervals and timing for schedule-related endpoints, see the Update Frequencies page to ensure you’re calling feeds at the optimal rate.
Retrieving Schedules
Season Schedules
You can retrieve complete schedules for the preseason (PRE), regular season (REG), and postseason (PST) using the Schedule endpoint. Specify the season_year as the starting year of the season (for example, 2025 for the 2025–26 season) and set the season_type to PRE, REG, or PST depending on the schedule you need.
You might want to pull the entire schedule to build out a season calendar, preload upcoming games, or keep your application in sync with official league dates.
Accessing Headshots and Team LogosTo access team logos and player headshots, use the Images API.
Daily Schedules
The Daily Schedule endpoint provides date, time, location, and other event details for every match-up taking place in the league defined day.
The following sample shows the NHL schedule for October 20, 2024.
<league xmlns="http://feed.elasticstats.com/schema/hockey/schedule-v7.0.xsd" id="fd560107-a85b-4388-ab0d-655ad022aff7" name="NHL" alias="NHL">
<daily-schedule date="2024-10-20">
<games>
<game id="392ef3c9-db32-4295-b9cf-6a05543bd287" status="closed" coverage="full" scheduled="2024-10-20T19:00:00Z" home_points="6" away_points="3" sr_id="sr:match:51245895" reference="20088" home_team="44180e55-0f24-11e2-8525-18a905767e44" away_team="4417b7d7-0f24-11e2-8525-18a905767e44">
<venue id="900327b2-73d0-4e44-a138-fbf4fcbb058f" name="Canada Life Centre" capacity="15321" address="300 Portage Avenue" city="Winnipeg" state="MB" zip="R3C 5S4" country="CAN" time_zone="US/Central" sr_id="sr:venue:6012">
<location lat="49.89279" lng="-97.14345"/>
</venue>
<season id="c5ca79d2-9e65-4987-84da-6f26237a47b3" year="2024" type="REG"/>
<time_zones venue="US/Central" home="US/Central" away="US/Eastern"/>
<home id="44180e55-0f24-11e2-8525-18a905767e44" name="Winnipeg Jets" alias="WPG" sr_id="sr:team:3676" reference="52">
</home>
<away id="4417b7d7-0f24-11e2-8525-18a905767e44" name="Pittsburgh Penguins" alias="PIT" sr_id="sr:team:3697" reference="5">
</away>
<broadcasts>
<broadcast network="ESPN+" type="Internet" locale="National"/>
<broadcast network="SportsNet PT" type="TV" locale="Away" channel="659"/>
</broadcasts>
</game>
<game id="8869b41a-6f42-48f6-bbba-dbb85795133b" status="closed" coverage="full" scheduled="2024-10-21T00:00:00Z" home_points="1" away_points="4" sr_id="sr:match:51245899" reference="20090" home_team="441862de-0f24-11e2-8525-18a905767e44" away_team="44151f7a-0f24-11e2-8525-18a905767e44">
<venue id="eb3866a7-4163-4517-bd42-d24e8c2522fe" name="Honda Center" capacity="17174" address="2695 E Katella Avenue" city="Anaheim" state="CA" zip="92806" country="USA" time_zone="US/Pacific" sr_id="sr:venue:5934">
<location lat="33.80785" lng="-117.87654"/>
</venue>
<season id="c5ca79d2-9e65-4987-84da-6f26237a47b3" year="2024" type="REG"/>
<time_zones venue="US/Pacific" home="US/Pacific" away="US/Pacific"/>
<home id="441862de-0f24-11e2-8525-18a905767e44" name="Anaheim Ducks" alias="ANA" sr_id="sr:team:3675" reference="24">
</home>
<away id="44151f7a-0f24-11e2-8525-18a905767e44" name="Los Angeles Kings" alias="LA" sr_id="sr:team:3688" reference="26">
</away>
<broadcasts>
<broadcast network="NHL Network" type="TV" locale="National" channel="215"/>
<broadcast network="Victory+" type="Internet" locale="Home"/>
<broadcast network="KCOP-TV" type="TV" locale="Home"/>
<broadcast network="FDSW" type="TV" locale="Away" channel="692"/>
</broadcasts>
</game>
<game id="e96d63bf-6b0e-4632-97f7-b60889fadb4e" status="closed" coverage="full" scheduled="2024-10-21T00:00:00Z" home_points="1" away_points="4" sr_id="sr:match:51245897" reference="20089" home_team="44155909-0f24-11e2-8525-18a905767e44" away_team="4415ce44-0f24-11e2-8525-18a905767e44">
<venue id="1da65282-af4c-4b81-a9de-344b76bb20b0" name="SAP Center at San Jose" capacity="17562" address="525 W Santa Clara Street" city="San Jose" state="CA" zip="95113" country="USA" time_zone="US/Pacific" sr_id="sr:venue:6046">
<location lat="37.33310526417009" lng="-121.90202205986886"/>
</venue>
<season id="c5ca79d2-9e65-4987-84da-6f26237a47b3" year="2024" type="REG"/>
<time_zones venue="US/Pacific" home="US/Pacific" away="US/Mountain"/>
<home id="44155909-0f24-11e2-8525-18a905767e44" name="San Jose Sharks" alias="SJ" sr_id="sr:team:3696" reference="28">
</home>
<away id="4415ce44-0f24-11e2-8525-18a905767e44" name="Colorado Avalanche" alias="COL" sr_id="sr:team:3682" reference="21">
</away>
<broadcasts>
<broadcast network="ESPN+" type="Internet" locale="National"/>
<broadcast network="NBCS-CA" type="TV" locale="Home" channel="698"/>
<broadcast network="ALT" type="TV" locale="Away" channel="681"/>
</broadcasts>
</game>
</games>
</daily-schedule>
</league>{
"date": "2024-10-20",
"league": {
"id": "fd560107-a85b-4388-ab0d-655ad022aff7",
"name": "NHL",
"alias": "NHL"
},
"games": [
{
"id": "392ef3c9-db32-4295-b9cf-6a05543bd287",
"status": "closed",
"coverage": "full",
"scheduled": "2024-10-20T19:00:00Z",
"home_points": 6,
"away_points": 3,
"sr_id": "sr:match:51245895",
"reference": "20088",
"season": {
"id": "c5ca79d2-9e65-4987-84da-6f26237a47b3",
"year": 2024,
"type": "REG"
},
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "900327b2-73d0-4e44-a138-fbf4fcbb058f",
"name": "Canada Life Centre",
"capacity": 15321,
"address": "300 Portage Avenue",
"city": "Winnipeg",
"state": "MB",
"zip": "R3C 5S4",
"country": "CAN",
"time_zone": "US/Central",
"sr_id": "sr:venue:6012",
"location": {
"lat": "49.89279",
"lng": "-97.14345"
}
},
"broadcasts": [
{
"network": "ESPN+",
"type": "Internet",
"locale": "National"
},
{
"network": "SportsNet PT",
"type": "TV",
"locale": "Away",
"channel": "659"
}
],
"home": {
"id": "44180e55-0f24-11e2-8525-18a905767e44",
"name": "Winnipeg Jets",
"alias": "WPG",
"sr_id": "sr:team:3676",
"reference": "52"
},
"away": {
"id": "4417b7d7-0f24-11e2-8525-18a905767e44",
"name": "Pittsburgh Penguins",
"alias": "PIT",
"sr_id": "sr:team:3697",
"reference": "5"
}
},
{
"id": "8869b41a-6f42-48f6-bbba-dbb85795133b",
"status": "closed",
"coverage": "full",
"scheduled": "2024-10-21T00:00:00Z",
"home_points": 1,
"away_points": 4,
"sr_id": "sr:match:51245899",
"reference": "20090",
"season": {
"id": "c5ca79d2-9e65-4987-84da-6f26237a47b3",
"year": 2024,
"type": "REG"
},
"time_zones": {
"venue": "US/Pacific",
"home": "US/Pacific",
"away": "US/Pacific"
},
"venue": {
"id": "eb3866a7-4163-4517-bd42-d24e8c2522fe",
"name": "Honda Center",
"capacity": 17174,
"address": "2695 E Katella Avenue",
"city": "Anaheim",
"state": "CA",
"zip": "92806",
"country": "USA",
"time_zone": "US/Pacific",
"sr_id": "sr:venue:5934",
"location": {
"lat": "33.80785",
"lng": "-117.87654"
}
},
"broadcasts": [
{
"network": "NHL Network",
"type": "TV",
"locale": "National",
"channel": "215"
},
{
"network": "Victory+",
"type": "Internet",
"locale": "Home"
},
{
"network": "KCOP-TV",
"type": "TV",
"locale": "Home"
},
{
"network": "FDSW",
"type": "TV",
"locale": "Away",
"channel": "692"
}
],
"home": {
"id": "441862de-0f24-11e2-8525-18a905767e44",
"name": "Anaheim Ducks",
"alias": "ANA",
"sr_id": "sr:team:3675",
"reference": "24"
},
"away": {
"id": "44151f7a-0f24-11e2-8525-18a905767e44",
"name": "Los Angeles Kings",
"alias": "LA",
"sr_id": "sr:team:3688",
"reference": "26"
}
},
{
"id": "e96d63bf-6b0e-4632-97f7-b60889fadb4e",
"status": "closed",
"coverage": "full",
"scheduled": "2024-10-21T00:00:00Z",
"home_points": 1,
"away_points": 4,
"sr_id": "sr:match:51245897",
"reference": "20089",
"season": {
"id": "c5ca79d2-9e65-4987-84da-6f26237a47b3",
"year": 2024,
"type": "REG"
},
"time_zones": {
"venue": "US/Pacific",
"home": "US/Pacific",
"away": "US/Mountain"
},
"venue": {
"id": "1da65282-af4c-4b81-a9de-344b76bb20b0",
"name": "SAP Center at San Jose",
"capacity": 17562,
"address": "525 W Santa Clara Street",
"city": "San Jose",
"state": "CA",
"zip": "95113",
"country": "USA",
"time_zone": "US/Pacific",
"sr_id": "sr:venue:6046",
"location": {
"lat": "37.33310526417009",
"lng": "-121.90202205986886"
}
},
"broadcasts": [
{
"network": "ESPN+",
"type": "Internet",
"locale": "National"
},
{
"network": "NBCS-CA",
"type": "TV",
"locale": "Home",
"channel": "698"
},
{
"network": "ALT",
"type": "TV",
"locale": "Away",
"channel": "681"
}
],
"home": {
"id": "44155909-0f24-11e2-8525-18a905767e44",
"name": "San Jose Sharks",
"alias": "SJ",
"sr_id": "sr:team:3696",
"reference": "28"
},
"away": {
"id": "4415ce44-0f24-11e2-8525-18a905767e44",
"name": "Colorado Avalanche",
"alias": "COL",
"sr_id": "sr:team:3682",
"reference": "21"
}
}
]
}You might use this instead of pulling the entire schedule when you only need to display or process games for a single day.
Series Schedules
The Series Schedule endpoint provides playoff participant information and the date, time, location, and other event details for every match-up taking place for the entire playoffs.
Ensure the season type is set to postseason (season_type = PST) when using this feed. Here is a snippet of the 2024 post season schedule.
<league xmlns="http://feed.elasticstats.com/schema/hockey/schedule-v6.0.xsd" id="fd560107-a85b-4388-ab0d-655ad022aff7" name="NHL" alias="NHL">
<season-schedule id="89d406e7-9d45-4e55-bdb3-5bf2a95b26d4" year="2024" type="PST">
<series id="03060dd2-ee5b-43b7-b2a2-26c5a3879377" title="Western Conference - Semifinals - DAL vs WPG" status="closed" round="2" start_date="2025-05-07">
<participant name="Stars" seed="3" record="4">
<team id="44157522-0f24-11e2-8525-18a905767e44" name="Stars" market="Dallas" alias="DAL" sr_id="sr:team:3684" reference="25"/>
<source id="38f95ece-a753-47d6-add9-71ee41f457a8" title="Western Conference - First Round - COL vs DAL" round="1" outcome="win"/>
<division id="94dee71b-a480-4c09-b890-274520a1567f" name="Central" alias="CENTRAL" seed="C2"/>
</participant>
<participant name="Jets" seed="1" record="2">
<team id="44180e55-0f24-11e2-8525-18a905767e44" name="Jets" market="Winnipeg" alias="WPG" sr_id="sr:team:3676" reference="52"/>
<source id="0fca7d27-8804-4ae6-b58b-af3e3afbcdbe" title="Western Conference - First Round - STL vs WPG" round="1" outcome="win"/>
<division id="94dee71b-a480-4c09-b890-274520a1567f" name="Central" alias="CENTRAL" seed="C1"/>
</participant>
<games>
<game id="33f5ebbe-b6be-4c36-a589-0de2068db979" title="Game 1" status="closed" coverage="full" scheduled="2025-05-08T01:30:00+00:00" home_points="2" away_points="3" sr_id="sr:match:59907334" reference="30231" home_team="44180e55-0f24-11e2-8525-18a905767e44" away_team="44157522-0f24-11e2-8525-18a905767e44">
<venue id="900327b2-73d0-4e44-a138-fbf4fcbb058f" name="Canada Life Centre" capacity="15321" address="300 Portage Avenue" city="Winnipeg" state="MB" zip="R3C 5S4" country="CAN" time_zone="US/Central" sr_id="sr:venue:6012">
<location lat="49.89279" lng="-97.14345"/>
</venue>
<time_zones venue="US/Central" home="US/Central" away="US/Central"/>
<home id="44180e55-0f24-11e2-8525-18a905767e44" name="Winnipeg Jets" alias="WPG" seed="1" sr_id="sr:team:3676" reference="52">
</home>
<away id="44157522-0f24-11e2-8525-18a905767e44" name="Dallas Stars" alias="DAL" seed="3" sr_id="sr:team:3684" reference="25">
</away>
<broadcasts>
<broadcast network="ESPN" type="TV" locale="National" channel="206"/>
<broadcast network="TVAS" type="TV" locale="International"/>
<broadcast network="CBC" type="TV" locale="International"/>
<broadcast network="SportsNet" type="TV" locale="International"/>
</broadcasts>
</game>
<game id="4b446c7b-aac7-4c59-acf4-8dbccad6f7ab" title="Game 2" status="closed" coverage="full" scheduled="2025-05-10T01:30:00+00:00" home_points="4" away_points="0" sr_id="sr:match:59907324" reference="30232" home_team="44180e55-0f24-11e2-8525-18a905767e44" away_team="44157522-0f24-11e2-8525-18a905767e44">
<venue id="900327b2-73d0-4e44-a138-fbf4fcbb058f" name="Canada Life Centre" capacity="15321" address="300 Portage Avenue" city="Winnipeg" state="MB" zip="R3C 5S4" country="CAN" time_zone="US/Central" sr_id="sr:venue:6012">
<location lat="49.89279" lng="-97.14345"/>
</venue>
<time_zones venue="US/Central" home="US/Central" away="US/Central"/>
<home id="44180e55-0f24-11e2-8525-18a905767e44" name="Winnipeg Jets" alias="WPG" seed="1" sr_id="sr:team:3676" reference="52">
</home>
<away id="44157522-0f24-11e2-8525-18a905767e44" name="Dallas Stars" alias="DAL" seed="3" sr_id="sr:team:3684" reference="25">
</away>
<broadcasts>
<broadcast network="TNT" type="TV" locale="National" channel="245"/>
<broadcast network="Max" type="Internet" locale="National"/>
<broadcast network="truTV" type="TV" locale="National" channel="246"/>
<broadcast network="TVAS" type="TV" locale="International"/>
<broadcast network="SportsNet" type="TV" locale="International"/>
<broadcast network="CBC" type="TV" locale="International"/>
</broadcasts>
</game>{
"league": {
"id": "fd560107-a85b-4388-ab0d-655ad022aff7",
"name": "NHL",
"alias": "NHL"
},
"season": {
"id": "89d406e7-9d45-4e55-bdb3-5bf2a95b26d4",
"year": 2024,
"type": "PST"
},
"series": [
{
"id": "03060dd2-ee5b-43b7-b2a2-26c5a3879377",
"title": "Western Conference - Semifinals - DAL vs WPG",
"status": "closed",
"round": 2,
"start_date": "2025-05-07",
"participants": [
{
"name": "Stars",
"seed": 3,
"record": 4,
"team": {
"id": "44157522-0f24-11e2-8525-18a905767e44",
"name": "Stars",
"market": "Dallas",
"alias": "DAL",
"sr_id": "sr:team:3684",
"reference": "25"
},
"source": {
"id": "38f95ece-a753-47d6-add9-71ee41f457a8",
"title": "Western Conference - First Round - COL vs DAL",
"round": 1,
"outcome": "win"
},
"division": {
"id": "94dee71b-a480-4c09-b890-274520a1567f",
"name": "Central",
"alias": "CENTRAL",
"seed": "C2"
}
},
{
"name": "Jets",
"seed": 1,
"record": 2,
"team": {
"id": "44180e55-0f24-11e2-8525-18a905767e44",
"name": "Jets",
"market": "Winnipeg",
"alias": "WPG",
"sr_id": "sr:team:3676",
"reference": "52"
},
"source": {
"id": "0fca7d27-8804-4ae6-b58b-af3e3afbcdbe",
"title": "Western Conference - First Round - STL vs WPG",
"round": 1,
"outcome": "win"
},
"division": {
"id": "94dee71b-a480-4c09-b890-274520a1567f",
"name": "Central",
"alias": "CENTRAL",
"seed": "C1"
}
}
],
"games": [
{
"id": "33f5ebbe-b6be-4c36-a589-0de2068db979",
"title": "Game 1",
"status": "closed",
"coverage": "full",
"scheduled": "2025-05-08T01:30:00+00:00",
"home_points": 2,
"away_points": 3,
"sr_id": "sr:match:59907334",
"reference": "30231",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Central"
},
"venue": {
"id": "900327b2-73d0-4e44-a138-fbf4fcbb058f",
"name": "Canada Life Centre",
"capacity": 15321,
"address": "300 Portage Avenue",
"city": "Winnipeg",
"state": "MB",
"zip": "R3C 5S4",
"country": "CAN",
"time_zone": "US/Central",
"sr_id": "sr:venue:6012",
"location": {
"lat": "49.89279",
"lng": "-97.14345"
}
},
"broadcasts": [
{
"network": "ESPN",
"type": "TV",
"locale": "National",
"channel": "206"
},
{
"network": "TVAS",
"type": "TV",
"locale": "International"
},
{
"network": "CBC",
"type": "TV",
"locale": "International"
},
{
"network": "SportsNet",
"type": "TV",
"locale": "International"
}
],
"home": {
"id": "44180e55-0f24-11e2-8525-18a905767e44",
"name": "Winnipeg Jets",
"alias": "WPG",
"seed": 1,
"sr_id": "sr:team:3676",
"reference": "52"
},
"away": {
"id": "44157522-0f24-11e2-8525-18a905767e44",
"name": "Dallas Stars",
"alias": "DAL",
"seed": 3,
"sr_id": "sr:team:3684",
"reference": "25"
}
},
{
"id": "4b446c7b-aac7-4c59-acf4-8dbccad6f7ab",
"title": "Game 2",
"status": "closed",
"coverage": "full",
"scheduled": "2025-05-10T01:30:00+00:00",
"home_points": 4,
"away_points": 0,
"sr_id": "sr:match:59907324",
"reference": "30232",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Central"
},
"venue": {
"id": "900327b2-73d0-4e44-a138-fbf4fcbb058f",
"name": "Canada Life Centre",
"capacity": 15321,
"address": "300 Portage Avenue",
"city": "Winnipeg",
"state": "MB",
"zip": "R3C 5S4",
"country": "CAN",
"time_zone": "US/Central",
"sr_id": "sr:venue:6012",
"location": {
"lat": "49.89279",
"lng": "-97.14345"
}
},
"broadcasts": [
{
"network": "TNT",
"type": "TV",
"locale": "National",
"channel": "245"
},
{
"network": "Max",
"type": "Internet",
"locale": "National"
},
{
"network": "truTV",
"type": "TV",
"locale": "National",
"channel": "246"
},
{
"network": "TVAS",
"type": "TV",
"locale": "International"
},
{
"network": "SportsNet",
"type": "TV",
"locale": "International"
},
{
"network": "CBC",
"type": "TV",
"locale": "International"
}
],
"home": {
"id": "44180e55-0f24-11e2-8525-18a905767e44",
"name": "Winnipeg Jets",
"alias": "WPG",
"seed": 1,
"sr_id": "sr:team:3676",
"reference": "52"
},
"away": {
"id": "44157522-0f24-11e2-8525-18a905767e44",
"name": "Dallas Stars",
"alias": "DAL",
"seed": 3,
"sr_id": "sr:team:3684",
"reference": "25"
}
},You can also use this feed to filter playoff games by conference or round, making it easier to generate playoff brackets (Guide Coming Soon).
Team Schedules
You can generate team-specific schedules by pulling data from the Daily Schedule, Schedule, or Series Schedule endpoints, then filtering the results locally for the team_id you are interested in.
-
Use the Team Profile or League Hierarchy endpoints to obtain a list of all teams.
-
Identify the
team_idvalues for the teams you want to track. -
Filter the dataset in your application by
team_idto isolate the games for that team.
Filtering locally by team_id allows you to build team calendars, display upcoming match-ups, or track team progress across the preseason, regular season, and playoffs.
Updated about 5 hours ago