Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasonal Faceoffs

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

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

Update Frequency

TTL / Cache: 4 hours

Data Updates: Seasonal stats update around 5 minutes after a game moves to closed


Data Points

Series 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 power play faceoffs won for a type (5v4, 5v3, 4v3)
lostplayer - faceoffs - by-strength - powerplay - strengthIntegerNumber of power play faceoffs lost for a type (5v4, 5v3, 4v3)
win_pctplayer - faceoffs - by-strength - powerplay - strengthDecimalPower play faceoff win percentage for a type (5v4, 5v3, 4v3)
totalplayer - faceoffs - by-strength - powerplay - strengthIntegerTotal number of power play 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

4v5, 3v5, 3v4
wonplayer - faceoffs - by-strength - shorthanded - strengthIntegerNumber of short-handed faceoffs won for a type (4v5, 3v5, 3v4)
lostplayer - faceoffs - by-strength - shorthanded - strengthIntegerNumber of short-handed faceoffs lost for a type (4v5, 3v5, 3v4)
win_pctplayer - faceoffs - by-strength - shorthanded - strengthDecimalShort-handed faceoff win percentage for a type (4v5, 3v5, 3v4)
totalplayer - faceoffs - by-strength - shorthanded - strengthIntegerTotal number of short-handed faceoffs for a type (4v5, 3v5, 3v4)
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

5v5, 4v4, 3v3
wonplayer - faceoffs - by-strength - evenstrength - strengthIntegerNumber of even strength faceoffs won for a type (5v5, 4v4, 3v3)
lostplayer - faceoffs - by-strength - evenstrength - strengthIntegerNumber of even strength faceoffs lost for a type (5v5, 4v4, 3v3)
win_pctplayer - faceoffs - by-strength - evenstrength - strengthDecimalEven strength faceoff win percentage for a type (5v5, 4v4, 3v3)
totalplayer - faceoffs - by-strength - evenstrength - strengthIntegerTotal number of even strength faceoffs for a type (5v5, 4v4, 3v3)
Game Faceoff Stats (Team)
AttributeParent ElementTypeDescription
wonteam_records - overall - faceoffsIntegerNumber of faceoffs won
lostteam_records - overall - faceoffsIntegerNumber of faceoffs lost
win_pctteam_records - overall - faceoffsDecimalFaceoff win percentage
totalteam_records - overall - faceoffsIntegerTotal number of faceoffs
wonteam_records - overall - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs won
lostteam_records - overall - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs lost
win_pctteam_records - overall - faceoffs - by-strength - powerplayDecimalPower play faceoff win percentage
totalteam_records - overall - faceoffs - by-strength - powerplayIntegerTotal number of power play faceoffs
wonteam_records - overall - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs won
lostteam_records - overall - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs lost
win_pctteam_records - overall - faceoffs - by-strength - shorthandedDecimalShort-handed faceoff win percentage
totalteam_records - overall - faceoffs - by-strength - shorthandedIntegerTotal number of short-handed faceoffs
wonteam_records - overall - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs won
lostteam_records - overall - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs lost
win_pctteam_records - overall - faceoffs - by-strength - evenstrengthDecimalEven strength faceoff win percentage
totalteam_records - overall - faceoffs - by-strength - evenstrengthIntegerTotal number of even strength faceoffs
Game Faceoff Stats (Opponent)
AttributeParent ElementTypeDescription
wonteam_records - opponents - faceoffsIntegerNumber of faceoffs won
lostteam_records - opponents - faceoffsIntegerNumber of faceoffs lost
win_pctteam_records - opponents - faceoffsDecimalFaceoff win percentage
totalteam_records - opponents - faceoffsIntegerTotal number of faceoffs
wonteam_records - opponents - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs won
lostteam_records - opponents - faceoffs - by-strength - powerplayIntegerNumber of power play faceoffs lost
win_pctteam_records - opponents - faceoffs - by-strength - powerplayDecimalPower play faceoff win percentage
totalteam_records - opponents - faceoffs - by-strength - powerplayIntegerTotal number of power play faceoffs
wonteam_records - opponents - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs won
lostteam_records - opponents - faceoffs - by-strength - shorthandedIntegerNumber of short-handed faceoffs lost
win_pctteam_records - opponents - faceoffs - by-strength - shorthandedDecimalShort-handed faceoff win percentage
totalteam_records - opponents - faceoffs - by-strength - shorthandedIntegerTotal number of short-handed faceoffs
wonteam_records - opponents - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs won
lostteam_records - opponents - faceoffs - by-strength - evenstrengthIntegerNumber of even strength faceoffs lost
win_pctteam_records - opponents - faceoffs - by-strength - evenstrengthDecimalEven strength faceoff win percentage
totalteam_records - opponents - faceoffs - by-strength - evenstrengthIntegerTotal number of even strength faceoffs
Player
AttributeParent ElementTypeDescription
first_nameplayerStringFirst name of a player

ex. Sidney
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
last_nameplayerStringLast name of a player

ex. Crosby
name_suffixplayerStringSuffix of a player

ex. Jr.
positionplayerStringPosition of a player

NA, D, F, F-D, G
primary_positionplayerStringPrimary position of a player

NA, C, D, G, LW, RW
referenceplayerStringLeague reference ID of a player

ex. 8471675
sr_idplayerGUIDUnique Sportradar ID of a player

ex. sr:player:31007
Series
AttributeParent ElementTypeDescription
idseriesGUIDUnique ID of a series

ex. 07299bd7-f693-4878-875c-f778731c9a23
titleseriesStringTitle of a series

ex. Western Conference - Finals - EDM vs COL
statusseriesStringStatus of a series

scheduled, inprogress, closed
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
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

REG (Regular Season), PST (Postseason)

Allowed:
string
required
Defaults to 44151f7a-0f24-11e2-8525-18a905767e44

Unique Id of a team

Example: 4416091c-0f24-11e2-8525-18a905767e44

Note: This endpoint is designed for team_ids which exist in the current League Hierarchy endpoint

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