Docs
Coverage MatrixDocumentationRelease LogLog In

Game Faceoffs

NHL Game Faceoffs provides detailed face-off information for teams and players, including period, zone, and strength breakdowns, for a given game.

⏱️

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
pointsteamIntegerTotal points for a team
idteamGUIDUnique ID of a team
ex. 4415b0a7-0f24-11e2-8525-18a905767e44
marketteamStringMarket name of a team
ex. Vancouver
nameteamStringTeam name
ex. Canucks
referenceteamStringLeague reference ID of a team
ex. 23
sr_idteamGUIDUnique Sportradar ID of a team
ex. sr:team:3692
hometeamBooleanSignifies the home team when true
strengthteamStringCurrent strength of a team
even, shorthanded, powerplay
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
Game Faceoff Stats (Player):
AttributeParent ElementTypeDescription
wonplayer - faceoffsIntegerNumber of faceoffs won
lostplayer - faceoffsIntegerNumber of faceoffs lost
win_pctplayer - faceoffsDecimalFaceoff win percentage
totalplayer - faceoffsIntegerTotal number of faceoffs
wonplayer - faceoffs - by-zone - offensiveIntegerNumber of offensive faceoffs won
lostplayer - faceoffs - by-zone - offensiveIntegerNumber of offensive faceoffs lost
win_pctplayer - faceoffs - by-zone - offensiveDecimalOffensive faceoff win percentage
totalplayer - faceoffs - by-zone - offensiveIntegerTotal number of offensive faceoffs
wonplayer - faceoffs - by-zone - defensiveIntegerNumber of defensive faceoffs won
lostplayer - faceoffs - by-zone - defensiveIntegerNumber of defensive faceoffs lost
win_pctplayer - faceoffs - by-zone - defensiveDecimalDefensive faceoff win percentage
totalplayer - faceoffs - by-zone - defensiveIntegerTotal number of defensive faceoffs
wonplayer - faceoffs - by-zone - neutralIntegerNumber of neutral faceoffs won
lostplayer - faceoffs - by-zone - neutralIntegerNumber of neutral faceoffs lost
win_pctplayer - faceoffs - by-zone - neutralDecimalNeutral faceoff win percentage
totalplayer - faceoffs - by-zone - neutralIntegerTotal number of neutral faceoffs
wonplayer - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs won
lostplayer - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs lost
win_pctplayer - faceoffs - by-strength - powerplayDecimalPower play faceoff win percentage
totalplayer - faceoffs - by-strength - powerplayIntegerTotal number of power play faceoffs
typeplayer - faceoffs - by-strength - powerplay - strengthStringType of power play situation
5v4, 5v3, 4v3
wonplayer - faceoffs - by-strength - powerplay - strengthIntegerNumber of short-handed faceoffs won for a type (5v4, 5v3, 4v3)
lostplayer - faceoffs - by-strength - powerplay - strengthIntegerNumber of short-handed faceoffs lost for a type (5v4, 5v3, 4v3)
win_pctplayer - faceoffs - by-strength - powerplay - strengthDecimalShort-handed faceoff win percentage for a type (5v4, 5v3, 4v3)
totalplayer - faceoffs - by-strength - powerplay - strengthIntegerTotal number of short-handed faceoffs for a type (5v4, 5v3, 4v3)
wonplayer - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs won
lostplayer - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs lost
win_pctplayer - faceoffs - by-strength - shorthandedDecimalShort-handed faceoff win percentage
totalplayer - faceoffs - by-strength - shorthandedIntegerTotal number of short-handed faceoffs
typeplayer - faceoffs - by-strength - shorthanded - strengthStringType of short-handed situation
5v4, 5v3, 4v3
wonplayer - faceoffs - by-strength - shorthanded - strengthIntegerNumber of short-handed faceoffs won for a type (5v4, 5v3, 4v3)
lostplayer - faceoffs - by-strength - shorthanded - strengthIntegerNumber of short-handed faceoffs lost for a type (5v4, 5v3, 4v3)
win_pctplayer - faceoffs - by-strength - shorthanded - strengthDecimalShort-handed faceoff win percentage for a type (5v4, 5v3, 4v3)
totalplayer - faceoffs - by-strength - shorthanded - strengthIntegerTotal number of short-handed faceoffs for a type (5v4, 5v3, 4v3)
wonplayer - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs won
lostplayer - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs lost
win_pctplayer - faceoffs - by-strength - evenstrengthDecimalEven strength faceoff win percentage
totalplayer - faceoffs - by-strength - evenstrengthIntegerTotal number of even strength faceoffs
typeplayer - faceoffs - by-strength - evenstrength - strengthStringType of even strength situation
5v4, 5v3, 4v3
wonplayer - faceoffs - by-strength - evenstrength - strengthIntegerNumber of even strength faceoffs won for a type (5v4, 5v3, 4v3)
lostplayer - faceoffs - by-strength - evenstrength - strengthIntegerNumber of even strength faceoffs lost for a type (5v4, 5v3, 4v3)
win_pctplayer - faceoffs - by-strength - evenstrength - strengthDecimalEven strength faceoff win percentage for a type (5v4, 5v3, 4v3)
totalplayer - faceoffs - by-strength - evenstrength - strengthIntegerTotal number of even strength faceoffs for a type (5v4, 5v3, 4v3)
Game Faceoff Stats (Team):
AttributeParent ElementTypeDescription
wonteam - faceoffsIntegerNumber of faceoffs won
lostteam - faceoffsIntegerNumber of faceoffs lost
win_pctteam - faceoffsDecimalFaceoff win percentage
totalteam - faceoffsIntegerTotal number of faceoffs
wonteam - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs won
lostteam - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs lost
win_pctteam - faceoffs - by-strength - powerplayDecimalPower play faceoff win percentage
totalteam - faceoffs - by-strength - powerplayIntegerTotal number of power play faceoffs
wonteam - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs won
lostteam - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs lost
win_pctteam - faceoffs - by-strength - shorthandedDecimalShort-handed faceoff win percentage
totalteam - faceoffs - by-strength - shorthandedIntegerTotal number of short-handed faceoffs
wonteam - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs won
lostteam - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs lost
win_pctteam - faceoffs - by-strength - evenstrengthDecimalEven strength faceoff win percentage
totalteam - faceoffs - by-strength - evenstrengthIntegerTotal number of even strength faceoffs
Period Faceoff Stats (Player):
AttributeParent ElementTypeDescription
idplayer - faceoffs - periodGUIDUnique ID of a period
ex. 84d1303d-6493-4db9-a827-b4a83bdc656a
typeplayer - faceoffs - periodStringType of period
ex. REG, OT
numberplayer - faceoffs - periodIntegerPeriod number
sequenceplayer - faceoffs - periodIntegerPeriod sequence number
wonplayer - faceoffs - periodIntegerNumber of faceoffs won in a period
lostplayer - faceoffs - periodIntegerNumber of faceoffs lost in a period
win_pctplayer - faceoffs - periodDecimalFaceoff win percentage in a period
totalplayer - faceoffs - periodIntegerTotal number of faceoffs in a period
wonplayer - faceoffs - period - by-zone - offensiveIntegerNumber of offensive faceoffs won in a period
lostplayer - faceoffs - period - by-zone - offensiveIntegerNumber of offensive faceoffs lost in a period
win_pctplayer - faceoffs - period - by-zone - offensiveDecimalOffensive faceoff win percentage in a period
totalplayer - faceoffs - period - by-zone - offensiveIntegerTotal number of offensive faceoffs in a period
wonplayer - faceoffs - period - by-zone - defensiveIntegerNumber of defensive faceoffs won in a period
lostplayer - faceoffs - period - by-zone - defensiveIntegerNumber of defensive faceoffs lost in a period
win_pctplayer - faceoffs - period - by-zone - defensiveDecimalDefensive faceoff win percentage in a period
totalplayer - faceoffs - period - by-zone - defensiveIntegerTotal number of defensive faceoffs in a period
wonplayer - faceoffs - period - by-zone - neutralIntegerNumber of neutral faceoffs won in a period
lostplayer - faceoffs - period - by-zone - neutralIntegerNumber of neutral faceoffs lost in a period
win_pctplayer - faceoffs - period - by-zone - neutralDecimalNeutral faceoff win percentage in a period
totalplayer - faceoffs - period - by-zone - neutralIntegerTotal number of neutral faceoffs in a period
Game:
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team
ex. 4416091c-0f24-11e2-8525-18a905767e44
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)
home_teamgameGUIDUnique ID of the home team
ex. 44157522-0f24-11e2-8525-18a905767e44
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
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
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!