Docs
Coverage MatrixDocumentationRelease LogLog In

Game Play-By-Play

NHL Game Play-By-Play provides detailed, real-time information on every team possession and game event.

⏱️

Update Frequency

TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.

Data Updates: Realtime



Data Points

Boxscore:
AttributeParent ElementTypeDescription
end_timegamedateTimeTimestamp of the end of a game
ex. 2022-12-06T06:09:52+00:00
start_timegamedateTimeTimestamp of the start of a game
ex. 2022-12-06T03:38:31+00:00
attendancegameIntegerAttendance of a game
ex. 18420
total_game_durationgameStringDuration of a game (in game time)
ex. 60:13
clockgameStringClock value of the game
ex. 5:37
periodgameIntegerCurrent period of a game
idperiodGUIDUnique ID of a period
ex. 84d1303d-6493-4db9-a827-b4a83bdc656a
numberperiodIntegerPeriod number
sequenceperiodIntegerPeriod sequence number
Game:
AttributeParent ElementTypeDescription
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
sr_idawayGUIDUnique Sportradar ID of the away team
ex. sr:team:3689
strengthawayStringCurrent strength of the away team
even, shorthanded, powerplay
coveragegameStringCoverage level of a game
full, boxscore
entry_modegameStringType of data entry for the game
INGEST(Ingested data from the league), LDE(Sportradar live data entry)
idgameGUIDUnique ID of a game
ex. 10b9ce0f-fd31-4d1f-828b-4f20d628f14f
referencegameStringLeague reference ID of a game
ex. 20393
scheduledgamedateTimeScheduled date and time of a game
ex. 2022-12-04T20:00:00Z
sr_idgameGUIDUnique Sportradar ID of a game
ex. sr:match:34542743
statusgameStringThe 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
sr_idhomeGUIDUnique Sportradar ID of the home team
ex. sr:team:3684
strengthhomeStringCurrent strength of the home team
even, shorthanded, powerplay
Play-by-Play - Event Attribution:
AttributeParent ElementTypeDescription
team_goalevent - attributionStringSide of the rink a team is defending
left, right
idevent - attributionGUIDUnique ID of a team
ex. 441713b7-0f24-11e2-8525-18a905767e44
marketevent - attributionStringMarket name of a team
ex. Minnesota
nameevent - attributionStringTeam name
ex. Wild
referenceevent - attributionStringLeague reference ID of a team
ex. 30
sr_idevent - attributionGUIDUnique Sportradar ID of a team
ex. sr:team:3689
Play-by-Play - Event:
AttributeParent ElementTypeDescription
clockeventStringClock value of an event
ex. 12:37
descriptioneventStringText description of an event
ex. Goal scored by Cole Caufield assisted by Jordan Harris
ideventGUIDUnique ID of an event
ex. d26ba273-2391-4248-be29-dea193092c5a
iddeleted_events - eventGUIDUnique ID of a deleted event
ex. d26ba273-2391-4248-be29-dea193092c5a
event_typeeventStringType of event
ex. goal or shotsaved

See our FAQ for a complete list of types
zoneeventStringZone of an event
defensive, offensive, neutral
officialeventBooleanSignifies an event is official and will count towards the statistical record
updatedeventdateTimeTimestamp of the last update to an event
ex. 2022-12-06T17:09:15Z
wall_clockeventdateTimeTimestamp of an event
ex. 2022-12-06T05:04:22Z
Play-by-Play - Event Details:
AttributeParent ElementTypeDescription
goal_zoneevent - detailsStringZone of a made goal (from the shooter's perspective)
upper left, upper middle, upper right, lower left, lower middle, lower right
penalty_codeevent - detailsStringLeague penalty reference ID/code
ex. 55, 80
durationevent - detailsIntegerDuration of a penalty in minutes
penalty_typeevent - detailsStringType of penalty
ex. Charging

See our FAQ for a list of valid penalty types
reasonevent - detailsStringEvent detail description
ex. wide of net, goalpost, TV timeout
distanceevent - detailsIntegerDistance of a shot on goal in feet
shot_typeevent - detailsIntegerType of a shot
wrist, slap, backhand, tip, snap, wrap-around, bat, cradle, poke, between_legs
stoppage_typeevent - detailsIntegerType of a stopp
ex. Referee or Linesman, Puck Frozen, Icing
Play-by-Play - Event Location:
AttributeParent ElementTypeDescription
action_areaevent - locationStringRink area of action for an event
ex. outsideleftcircle
coord_xevent - locationIntegerX coordinate of an event. The rink we use is 2400 by 1020; the scale is in inches.
coord_yevent - locationIntegerY coordinate of an event. The rink we use is 2400 by 1020; the scale is in inches.
Play-by-Play - Event Participants: > Players and teams will appear within each event in different contexts. This will include: substitutions, on ice info, faceoffs, and event statistics such as missed shots or goals.
AttributeParent ElementTypeDescription
full_nameevent - playerStringFull name of a player
ex. Sidney Crosby
idevent - playerGUIDUnique ID of a player
ex. 433de553-0f24-11e2-8525-18a905767e44
jersey_numberevent - playerIntegerNumber of a player's jersey
referenceevent - playerStringLeague reference ID of a player
ex. 8471675
sr_idevent - playerGUIDUnique Sportradar ID of a player
ex. sr:player:31007
idevent - teamGUIDUnique ID of a team
ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketevent - teamStringMarket name of a team
ex. Minnesota
nameevent - teamStringTeam name
ex. Wild
referenceevent - teamStringLeague reference ID of a team
ex. 30
sr_idevent - teamGUIDUnique Sportradar ID of a team
ex. sr:team:3689
Play-by-Play - On Ice:
AttributeParent ElementTypeDescription
full_nameevent - on-ice - playerStringFull name of a player
ex. Sidney Crosby
idevent - on-ice - playerGUIDUnique ID of a player
ex. 433de553-0f24-11e2-8525-18a905767e44
jersey_numberevent - on-ice - playerIntegerNumber of a player's jersey
referenceevent - on-ice - playerStringLeague reference ID of a player
ex. 8471675
sr_idevent - on-ice - playerGUIDUnique Sportradar ID of a player
ex. sr:player:31007
idevent - on-ice - teamGUIDUnique ID of a team
ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketevent - on-ice - teamStringMarket name of a team
ex. Minnesota
nameevent - on-ice - teamStringTeam name
ex. Wild
referenceevent - on-ice - teamStringLeague reference ID of a team
ex. 30
sr_idevent - on-ice - teamGUIDUnique Sportradar ID of a team
ex. sr:team:3689
Play Statistics:
AttributeParent ElementTypeDescription
strengthevent - statistics - assistStringStrength for an assist event
even, powerplay, shorthanded
assist_typeevent - statistics - assistStringType of assist
primary, secondary
zoneevent - statistics - assistStringZone of an assist event
defensive, offensive, neutral
strengthevent - statistics - blockStringStrength for a block event
even, powerplay, shorthanded
zoneevent - statistics - blockStringZone of a block event
defensive, offensive, neutral
strengthevent - statistics - faceoffStringStrength for a faceoff event
even, powerplay, shorthanded
winevent - statistics - faceoffBooleanSignifies a won faceoff
zoneevent - statistics - blfaceoffockStringZone of a faceoff event
defensive, offensive, neutral
strengthevent - statistics - giveawayStringStrength for a giveaway event
even, powerplay, shorthanded
zoneevent - statistics - giveawayStringZone of a giveaway event
defensive, offensive, neutral
strengthevent - statistics - hitStringStrength for the hitter a hit event
even, powerplay, shorthanded
zoneevent - statistics - hitStringZone of the hitter a hit event
defensive, offensive, neutral
strengthevent - statistics - hitteeStringStrength for the player hit in a hit event
even, powerplay, shorthanded
zoneevent - statistics - hitteeStringZone of the player hit in a hit event
defensive, offensive, neutral
penaltyevent - statistics - shotmissedBooleanSignifies a missed penalty shot
shootoutevent - statistics - shotmissedBooleanSignifies a missed shootout shot
strengthevent - statistics - shotmissedStringStrength for a missed shot event
even, powerplay, shorthanded
zoneevent - statistics - shotmissedStringZone for a missed shot event
defensive, offensive, neutral
minutesevent - statistics - penaltyIntegerNumber of penalty minutes
severityevent - statistics - penaltyStringSeverity of a penalty
Minor, Major, Double Minor, Misconduct
strengthevent - statistics - penaltyStringStrength for a penalty event
even, powerplay, shorthanded
minutesevent - statistics - penaltydrawnIntegerNumber of penalty minutes for a player drawing a penalty
severityevent - statistics - penaltydrawnStringSeverity of a penalty for a player drawing a penalty
Minor, Major, Double Minor, Misconduct
strengthevent - statistics - penaltydrawnStringStrength of a penalty event for a player drawing a penalty
even, powerplay, shorthanded
minutesevent - statistics - penaltyservedIntegerNumber of penalty minutes served
severityevent - statistics - penaltyservedStringSeverity of a penalty served
Minor, Major, Double Minor, Misconduct
strengthevent - statistics - penaltyservedStringStrength of a penalty served event
even, powerplay, shorthanded
awardedevent - statistics - shotBooleanSignifies an awarded shot
goalevent - statistics - shotBooleanSignifies a goal score
penaltyevent - statistics - shotBooleanSignifies a penalty shot
shootoutevent - statistics - shotBooleanSignifies a shootout shot
strengthevent - statistics - shotStringStrength of a shot event
even, powerplay, shorthanded
zoneevent - statistics - shotStringZone for a shot event
defensive, offensive, neutral
awardedevent - statistics - shotagainstBooleanSignifies an awarded shot against
goalevent - statistics - shotagainstBooleanSignifies a goal score against
penaltyevent - statistics - shotagainstBooleanSignifies a penalty shot against
shootoutevent - statistics - shotagainstBooleanSignifies a shootout shot against
strengthevent - statistics - shotagainstStringStrength of a shot event for the defense
even, powerplay, shorthanded
zoneevent - statistics - shotagainstStringZone for a shot event for the defense
defensive, offensive, neutral
strengthevent - statistics - takeawayStringStrength of a takeaway event
even, powerplay, shorthanded
zoneevent - statistics - takeawayStringZone for a takeaway event
defensive, offensive, neutral
Player:
AttributeParent ElementTypeDescription
full_nameplayerStringFull name of a player
ex. Sidney Crosby
idplayerGUIDUnique ID of a player
ex. 433de553-0f24-11e2-8525-18a905767e44
jersey_numberplayerIntegerNumber of a player's jersey
positionplayerStringPosition of a player
NA, D, F, F-D, G
referenceplayerStringLeague reference ID of a player
ex. 8471675
sr_idplayerGUIDUnique Sportradar ID of a player
ex. sr:player:31007
Team:
AttributeParent ElementTypeDescription
idteamGUIDUnique ID of a team
ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team
ex. Minnesota
nameteamStringTeam name
ex. Wild
referenceteamStringLeague reference ID of a team
ex. 30
sr_idteamGUIDUnique Sportradar ID of a team
ex. sr:team:3689
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
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
Language
Authorization
Query
Click Try It! to start a request and see the response here!