⏱️
Update Frequency
TTL / Cache:

60 seconds when a game is in scheduled status

3 seconds when a game moves to inprogress

600 seconds when a game moves to closed

4 hours when seven days have passed since closed

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 game `REG` (Regular Season), `PST` (Postseason), `PRE` (Preseason)
`year`	`season`	Integer	Year of a game's season `2022` = 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 team `even`, `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 situation `5v4`, `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 situation `5v4`, `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 situation `5v4`, `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 game `full`, `boxscore`
`entry_mode`	`game`	String	Type of data entry for the game `INGEST` (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. `2026-04-17T02:30:00+00:00`
`sr_id`	`game`	GUID	Unique Sportradar ID of a game ex. `sr:match:34542743`
`status`	`game`	String	The 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
`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 player `NA`, `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`

200200