get https://api.sportradar.com/nhl//v7//games//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
League:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | season | GUID | Unique ID of a game's season ex. 5d08ca09-ec49-4559-9c0f-257c0158e57f |
type | season | String | Season type for a gameREG (Regular Season), PST (Postseason), PRE (Preseason) |
year | season | Integer | Year of a game's season2022 = 2022-23 Season |
Boxscore:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
end_time | game | dateTime | Timestamp of the end of a game ex. 2022-12-06T06:09:52+00:00 |
start_time | game | dateTime | Timestamp of the start of a game ex. 2022-12-06T03:38:31+00:00 |
attendance | game | Integer | Attendance of a game ex. 18420 |
points | team | Integer | Total points for a team |
id | team | GUID | Unique ID of a team ex. 4415b0a7-0f24-11e2-8525-18a905767e44 |
market | team | String | Market name of a team ex. Vancouver |
name | team | String | Team name ex. Canucks |
reference | team | String | League reference ID of a team ex. 23 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3692 |
home | team | Boolean | Signifies the home team when true |
strength | team | String | Current strength of a teameven, shorthanded, powerplay |
total_game_duration | game | String | Duration of a game (in game time) ex. 60:13 |
clock | game | String | Clock value of the game ex. 5:37 |
period | game | Integer | Current period of a game |
Game Faceoff Stats (Player):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
won | player - faceoffs | Integer | Number of faceoffs won |
lost | player - faceoffs | Integer | Number of faceoffs lost |
win_pct | player - faceoffs | Decimal | Faceoff win percentage |
total | player - faceoffs | Integer | Total number of faceoffs |
won | player - faceoffs - by-zone - offensive | Integer | Number of offensive faceoffs won |
lost | player - faceoffs - by-zone - offensive | Integer | Number of offensive faceoffs lost |
win_pct | player - faceoffs - by-zone - offensive | Decimal | Offensive faceoff win percentage |
total | player - faceoffs - by-zone - offensive | Integer | Total number of offensive faceoffs |
won | player - faceoffs - by-zone - defensive | Integer | Number of defensive faceoffs won |
lost | player - faceoffs - by-zone - defensive | Integer | Number of defensive faceoffs lost |
win_pct | player - faceoffs - by-zone - defensive | Decimal | Defensive faceoff win percentage |
total | player - faceoffs - by-zone - defensive | Integer | Total number of defensive faceoffs |
won | player - faceoffs - by-zone - neutral | Integer | Number of neutral faceoffs won |
lost | player - faceoffs - by-zone - neutral | Integer | Number of neutral faceoffs lost |
win_pct | player - faceoffs - by-zone - neutral | Decimal | Neutral faceoff win percentage |
total | player - faceoffs - by-zone - neutral | Integer | Total number of neutral faceoffs |
won | player - faceoffs - by-strength - powerplay | Integer | Number of power play faceoffs won |
lost | player - faceoffs - by-strength - powerplay | Integer | Number of power play faceoffs lost |
win_pct | player - faceoffs - by-strength - powerplay | Decimal | Power play faceoff win percentage |
total | player - faceoffs - by-strength - powerplay | Integer | Total number of power play faceoffs |
type | player - faceoffs - by-strength - powerplay - strength | String | Type of power play situation5v4, 5v3, 4v3 |
won | player - faceoffs - by-strength - powerplay - strength | Integer | Number of short-handed faceoffs won for a type (5v4, 5v3, 4v3) |
lost | player - faceoffs - by-strength - powerplay - strength | Integer | Number of short-handed faceoffs lost for a type (5v4, 5v3, 4v3) |
win_pct | player - faceoffs - by-strength - powerplay - strength | Decimal | Short-handed faceoff win percentage for a type (5v4, 5v3, 4v3) |
total | player - faceoffs - by-strength - powerplay - strength | Integer | Total number of short-handed faceoffs for a type (5v4, 5v3, 4v3) |
won | player - faceoffs - by-strength - shorthanded | Integer | Number of short-handed faceoffs won |
lost | player - faceoffs - by-strength - shorthanded | Integer | Number of short-handed faceoffs lost |
win_pct | player - faceoffs - by-strength - shorthanded | Decimal | Short-handed faceoff win percentage |
total | player - faceoffs - by-strength - shorthanded | Integer | Total number of short-handed faceoffs |
type | player - faceoffs - by-strength - shorthanded - strength | String | Type of short-handed situation5v4, 5v3, 4v3 |
won | player - faceoffs - by-strength - shorthanded - strength | Integer | Number of short-handed faceoffs won for a type (5v4, 5v3, 4v3) |
lost | player - faceoffs - by-strength - shorthanded - strength | Integer | Number of short-handed faceoffs lost for a type (5v4, 5v3, 4v3) |
win_pct | player - faceoffs - by-strength - shorthanded - strength | Decimal | Short-handed faceoff win percentage for a type (5v4, 5v3, 4v3) |
total | player - faceoffs - by-strength - shorthanded - strength | Integer | Total number of short-handed faceoffs for a type (5v4, 5v3, 4v3) |
won | player - faceoffs - by-strength - evenstrength | Integer | Number of even strength faceoffs won |
lost | player - faceoffs - by-strength - evenstrength | Integer | Number of even strength faceoffs lost |
win_pct | player - faceoffs - by-strength - evenstrength | Decimal | Even strength faceoff win percentage |
total | player - faceoffs - by-strength - evenstrength | Integer | Total number of even strength faceoffs |
type | player - faceoffs - by-strength - evenstrength - strength | String | Type of even strength situation5v4, 5v3, 4v3 |
won | player - faceoffs - by-strength - evenstrength - strength | Integer | Number of even strength faceoffs won for a type (5v4, 5v3, 4v3) |
lost | player - faceoffs - by-strength - evenstrength - strength | Integer | Number of even strength faceoffs lost for a type (5v4, 5v3, 4v3) |
win_pct | player - faceoffs - by-strength - evenstrength - strength | Decimal | Even strength faceoff win percentage for a type (5v4, 5v3, 4v3) |
total | player - faceoffs - by-strength - evenstrength - strength | Integer | Total number of even strength faceoffs for a type (5v4, 5v3, 4v3) |
Game Faceoff Stats (Team):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
won | team - faceoffs | Integer | Number of faceoffs won |
lost | team - faceoffs | Integer | Number of faceoffs lost |
win_pct | team - faceoffs | Decimal | Faceoff win percentage |
total | team - faceoffs | Integer | Total number of faceoffs |
won | team - faceoffs - by-strength - powerplay | Integer | Number of power play faceoffs won |
lost | team - faceoffs - by-strength - powerplay | Integer | Number of power play faceoffs lost |
win_pct | team - faceoffs - by-strength - powerplay | Decimal | Power play faceoff win percentage |
total | team - faceoffs - by-strength - powerplay | Integer | Total number of power play faceoffs |
won | team - faceoffs - by-strength - shorthanded | Integer | Number of short-handed faceoffs won |
lost | team - faceoffs - by-strength - shorthanded | Integer | Number of short-handed faceoffs lost |
win_pct | team - faceoffs - by-strength - shorthanded | Decimal | Short-handed faceoff win percentage |
total | team - faceoffs - by-strength - shorthanded | Integer | Total number of short-handed faceoffs |
won | team - faceoffs - by-strength - evenstrength | Integer | Number of even strength faceoffs won |
lost | team - faceoffs - by-strength - evenstrength | Integer | Number of even strength faceoffs lost |
win_pct | team - faceoffs - by-strength - evenstrength | Decimal | Even strength faceoff win percentage |
total | team - faceoffs - by-strength - evenstrength | Integer | Total number of even strength faceoffs |
Period Faceoff Stats (Player):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | player - faceoffs - period | GUID | Unique ID of a period ex. 84d1303d-6493-4db9-a827-b4a83bdc656a |
type | player - faceoffs - period | String | Type of period ex. REG, OT |
number | player - faceoffs - period | Integer | Period number |
sequence | player - faceoffs - period | Integer | Period sequence number |
won | player - faceoffs - period | Integer | Number of faceoffs won in a period |
lost | player - faceoffs - period | Integer | Number of faceoffs lost in a period |
win_pct | player - faceoffs - period | Decimal | Faceoff win percentage in a period |
total | player - faceoffs - period | Integer | Total number of faceoffs in a period |
won | player - faceoffs - period - by-zone - offensive | Integer | Number of offensive faceoffs won in a period |
lost | player - faceoffs - period - by-zone - offensive | Integer | Number of offensive faceoffs lost in a period |
win_pct | player - faceoffs - period - by-zone - offensive | Decimal | Offensive faceoff win percentage in a period |
total | player - faceoffs - period - by-zone - offensive | Integer | Total number of offensive faceoffs in a period |
won | player - faceoffs - period - by-zone - defensive | Integer | Number of defensive faceoffs won in a period |
lost | player - faceoffs - period - by-zone - defensive | Integer | Number of defensive faceoffs lost in a period |
win_pct | player - faceoffs - period - by-zone - defensive | Decimal | Defensive faceoff win percentage in a period |
total | player - faceoffs - period - by-zone - defensive | Integer | Total number of defensive faceoffs in a period |
won | player - faceoffs - period - by-zone - neutral | Integer | Number of neutral faceoffs won in a period |
lost | player - faceoffs - period - by-zone - neutral | Integer | Number of neutral faceoffs lost in a period |
win_pct | player - faceoffs - period - by-zone - neutral | Decimal | Neutral faceoff win percentage in a period |
total | player - faceoffs - period - by-zone - neutral | Integer | Total number of neutral faceoffs in a period |
Game:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
away_team | game | GUID | Unique ID of the away team ex. 4416091c-0f24-11e2-8525-18a905767e44 |
coverage | game | String | Coverage level of a gamefull, boxscore |
entry_mode | game | String | Type of data entry for the gameINGEST(Ingested data from the league), LDE(Sportradar live data entry) |
home_team | game | GUID | Unique ID of the home team ex. 44157522-0f24-11e2-8525-18a905767e44 |
id | game | GUID | Unique ID of a game ex. 10b9ce0f-fd31-4d1f-828b-4f20d628f14f |
reference | game | String | League reference ID of a game ex. 20393 |
scheduled | game | dateTime | Scheduled date and time of a game ex. 2022-12-04T20:00:00Z |
sr_id | game | GUID | Unique Sportradar ID of a game ex. sr:match:34542743 |
status | game | String | The status of a gamescheduled, created, inprogress, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessaryPlease see our FAQ section for a list of game status definitions |
away | game - time_zones | String | Time zone of the away team ex. US/Pacific |
home | game - time_zones | String | Time zone of the home team ex. US/Eastern |
venue | game - time_zones | String | Time zone of the venue ex. US/Eastern |
title | game | String | Title of a game ex. Game 3 |
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
full_name | player | String | Full name of a player ex. Sidney Crosby |
id | player | GUID | Unique ID of a player ex. 433de553-0f24-11e2-8525-18a905767e44 |
jersey_number | player | Integer | Number of a player's jersey |
position | player | String | Position of a playerNA, D, F, F-D, G |
reference | player | String | League reference ID of a player ex. 8471675 |
sr_id | player | GUID | Unique Sportradar ID of a player ex. sr:player:31007 |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 2500 Victory Avenue |
capacity | venue | String | Capacity of a venue ex. 18532 |
city | venue | String | City of a venue ex. Dallas |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. adbd1acb-a053-4944-ba15-383eda91c12e |
lat | venue - location | Decimal | Latitude of a venue ex. 44.94478 |
lng | venue - location | Decimal | Longitude of a venue ex. -93.10118 |
name | venue | String | Name of a venue ex. American Airlines Center |
sr_id | venue | GUID | Unique Sportradar ID of a venue ex. sr:venue:5988 |
state | venue | String | State or province of a venue ex. TX |
time_zone | venue | String | Time zone of the venue ex. US/Central |
zip | venue | Integer | ZIP code of a venue ex. 75219 |