Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Schedule

NHL Schedule provides date, time, location, and other event details for every match-up taking place in the full league season.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache:

  • 10 minutes when season includes active games (games in non-closed status)
  • 4 hours when no active games

Data Updates: Schedule info updates in realtime as changes are made

📘

Loading Schedules

Learn how to use the Schedule feed to load a season's full slate and locate game IDs in our Schedules integration scenario.


Data Points

Game
AttributeParent ElementTypeDescription
aliasawayStringAbbreviation of the away team

ex. MIN (Minnesota)
idawayGUIDUnique ID of the away team

ex. 4416091c-0f24-11e2-8525-18a905767e44
away_teamgameGUIDUnique ID of the away team

ex. 4416091c-0f24-11e2-8525-18a905767e44
nameawayStringTeam name of the away team

ex. Minnesota Wild
away_pointsgameIntegerNumber of points for the away team
referenceawayStringLeague reference ID of the away team

ex. 30
seedawayIntegerPlayoff seed number for the away team
sr_idawayGUIDUnique Sportradar ID of the away team

ex. sr:team:3689
cablebroadcastStringName of the game's broadcast cable station
channelbroadcastStringName of a game's broadcast channel

ex. 215
localebroadcastStringSignifies the locale of a broadcast

ex. Home, Away, National, International
networkbroadcastStringName of a game's broadcast network

ex. NHL Network
typebroadcastStringType of broadcast

ex. TV
urlbroadcastStringWebsite URL of a game
coveragegameStringCoverage level of a game

full, boxscore
idgameGUIDUnique ID of a game

ex. 10b9ce0f-fd31-4d1f-828b-4f20d628f14f
parent_idgameGUIDStandard parent ID of a game. Use this ID to group events (like the Stanley Cup) across seasons.
referencegameStringLeague reference ID of a game

ex. 20393
scheduledgamedateTimeScheduled date and time of a game

ex. 2026-04-17T02:30:00+00:00
sr_idgameGUIDUnique Sportradar ID of a game

ex. sr:match:34542743
statusmetadataStringThe status of a game

scheduled, created, inprogress, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessary

Please see our FAQ section for a list of game status definitions
titlegameStringTitle of a game

ex. Game 3
aliashomeStringAbbreviation of the home team

ex. DAL (Dallas)
idhomeGUIDUnique ID of the home team

ex. 44157522-0f24-11e2-8525-18a905767e44
home_teamgameGUIDUnique ID of the home team

ex. 44157522-0f24-11e2-8525-18a905767e44
namehomeStringTeam name of the home team

ex. Dallas Stars
home_pointsgameIntegerNumber of points for the home team
referencehomeStringLeague reference ID of the home team

ex. 25
seedhomeIntegerPlayoff seed number for the home team
sr_idhomeGUIDUnique Sportradar ID of the home team

ex. sr:team:3684
awaygame - time_zonesStringTime zone of the away team

ex. US/Pacific
homegame - time_zonesStringTime zone of the home team

ex. US/Eastern
venuegame - time_zonesStringTime zone of the venue

ex. US/Eastern
League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. NHL
idleagueGUIDUnique ID of a league

ex. fd560107-a85b-4388-ab0d-655ad022aff7
nameleagueStringName of a league

ex. NHL
idseason-scheduleGUIDUnique ID of a season

ex. 5d08ca09-ec49-4559-9c0f-257c0158e57f
typeseason-scheduleStringType of season

REG(Regular Season), PST(Postseason)
yearseason-scheduleIntegerYear of a season

2022 = 2022-23 Season
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 2500 Victory Avenue
capacityvenueStringCapacity of a venue

ex. 18532
cityvenueStringCity of a venue

ex. Dallas
countryvenueStringCountry of a venue

ex. USA
idvenueGUIDUnique ID of a venue

ex. adbd1acb-a053-4944-ba15-383eda91c12e
latvenue - locationDecimalLatitude of a venue

ex. 44.94478
lngvenue - locationDecimalLongitude of a venue

ex. -93.10118
namevenueStringName of a venue

ex. American Airlines Center
sr_idvenueGUIDUnique Sportradar ID of a venue

ex. sr:venue:5988
statevenueStringState or province of a venue

ex. TX
time_zonevenueStringTime zone of the venue

ex. US/Central
zipvenueIntegerZIP code of a venue

ex. 75219
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

br (Brazilian Portuguese), en (English), es (Spanish), fr (French), ru (Russian), zh (Simplified Chinese)

Allowed:
string
enum
required
Defaults to 2025

Year of a season in YYYY format

Note: Season year is always the year a season begins. For example, 2024 for the 2024-25 season.

string
enum
required
Defaults to REG

Type of season

PRE (Preseason), REG (Regular Season), PST (Postseason)

Allowed:
string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json