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


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