Game Roster

⏱️
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

Attribute	Parent Element	Type	Description
`attendance`	`game`	Integer	Attendance of a game ex. `73242`
`remaining_challenges`	`away`	Integer	Away team challenges remaining
`remaining_timeouts`	`away`	Integer	Away team timeouts remaining
`used_challenges`	`away`	Integer	Away team challenges used
`used_timeouts`	`away`	Integer	Away team timeouts used
`points`	`away`	Integer	Away team total points
`clock`	`game`	String	Clock value of the game ex. `12:37`
`remaining_challenges`	`home`	Integer	Home team challenges remaining
`remaining_timeouts`	`home`	Integer	Home team timeouts remaining
`used_challenges`	`home`	Integer	Home team challenges used
`used_timeouts`	`home`	Integer	Home team timeouts used
`points`	`home`	Integer	Home team total points
`quarter`	`game`	Integer	Quarter number of the game

Officials

Attribute	Parent Element	Type	Description
`assignment`	`official`	String	Official assignment ex. `linejudge` or `replayofficial`
`id`	`official`	GUID	Unique ID of an official ex. `77980520-3898-11ee-b2de-574aa938ad02`
`full_name`	`official`	String	Full name of an official ex. `Brad Rogers`
`number`	`official`	Integer	Jersey number of an official

Draft

Attribute	Parent Element	Type	Description
`number`	`draft`	Integer	Draft pick number of a player
`round`	`draft`	Integer	Draft pick round of a player
`year`	`draft`	Integer	Draft year of a player
`alias`	`draft` - `team`	String	Draft team alias ex. `MIN` (Minnesota)
`id`	`draft` - `team`	GUID	Unique ID of a draft team ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`draft` - `team`	String	Draft team market name ex. `Minnesota`
`name`	`draft` - `team`	String	Draft team name ex. `Vikings`
`sr_id`	`draft` - `team`	String	Unique Sportradar ID of a draft team ex. `sr:competitor:4324`

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Away team alias ex. `MIN` (Minnesota)
`id`	`away`	GUID	Unique ID of the away team ex. `768c92aa-75ff-4a43-bcc0-f2798c2e1724`
`market`	`away`	String	Away team market name ex. `Minnesota`
`name`	`away`	String	Away team name ex. `Vikings`
`sr_id`	`away`	String	Unique Sportradar ID of the away team ex. `sr:competitor:4376`
`internet`	`broadcast`	String	Name of a game's internet stream ex. `ESPN+`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `Amazon Prime Video`
`radio`	`broadcast`	String	Name of a game's radio station ex. `Sirius 134, XM 231`
`satellite`	`broadcast`	String	Name of a game's broadcast satellite station ex. `ESPN Ocho`
`conference_game`	`game`	Boolean	Signifies an in-Conference matchup ex. (NFC vs. NFC)
`duration`	`game`	String	Duration of the game ex. `2:52`
`entry_mode`	`game`	String	Type of data entry for the game `LDE` (Live Data Entry)
`game_type`	`game`	String	Type of game `regular`, `playoff`
`alias`	`home`	String	Home team alias ex. `GB` (Green Bay)
`id`	`home`	GUID	Unique ID of the home team ex. `7b112545-38e6-483c-a55c-96cf6ee49cb8`
`market`	`home`	String	Home team market name ex. `Green Bay`
`name`	`home`	String	Home team name ex. `Packers`
`sr_id`	`home`	String	Unique Sportradar ID of the home team ex. `sr:competitor:4391`
`id`	`game`	GUID	Unique ID of a game ex. `13025660-aa95-4885-b33e-3a3554d4c4c3`
`neutral_site`	`game`	Boolean	Signifies a game is held at a neutral site
`number`	`game`	Integer	Game number
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like the Super Bowl) across seasons.
`scheduled`	`game`	Date/Time	Scheduled date and time of a game ex. `2022-09-25T20:10:00+00:00`
`sr_id`	`game`	String	Unique Sportradar ID of a game ex. `sr:match:33623305`
`status`	`game`	String	Game status `scheduled`, `created`, `inprogress`, `complete`, `closed`, `cancelled`, `delayed`, `suspended`, `postponed`, `time-tbd`, `if necessary`, `unnecessary` See our NFL FAQ for game status descriptions
`title`	`game`	String	Game title ex. `NFC Championship`
`away`	`time_zones`	String	Time zone of the away team ex. `US/Pacific`
`home`	`time_zones`	String	Time zone of the home team ex. `US/Eastern`
`venue`	`time_zones`	String	Time zone of the venue ex. `US/Eastern`
`condition`	`weather`	String	Weather condition for a game ex. `Partly cloudy`, `Clear`, `Light Rain, Mist` Click here for more info on weather condition values
`humidity`	`weather`	Byte	Humidity conditions for a game ex. `44`
`temp`	`weather`	Byte	Temperature of a game in Fahrenheit ex. `57`
`direction`	`wind`	String	Wind direction for a game ex. `N`
`speed`	`wind`	Byte	Wind speed for a game in MPH

League

Attribute	Parent Element	Type	Description
`id`	`season`	GUID	Unique season ID ex. `75749c10-56c1-4ae0-9d1e-2689708debdf`
`name`	`season`	String	Name of the season `PRE`, `REG`, `PST`
`type`	`season`	String	Type of the season `PRE`, `REG`, `PST`
`year`	`season`	Integer	Year of the season
`id`	`week`	GUID	Unique week ID ex. `57b447ce-bc66-47f7-9760-89d328d3db9f`
`sequence`	`week`	Integer	Week sequence number
`title`	`week`	String	Week title

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `P.Mahomes`
`age`	`player`	Integer	Age of a player at the time of the game
`birth_date`	`player`	Date	Player date of birth ex. `1995-09-17`
`birth_place`	`player`	String	Birthplace of a player ex. `Tyler, TX, USA`
`college`	`player`	String	College attended ex. `Texas Tech`
`college_conf`	`player`	String	College Conference ex. `Big Twelve`
`first_name`	`player`	String	First name of a player ex. `Patrick`
`name`	`player`	String	Full name of a player ex. `Patrick Mahomes`
`height`	`player`	Integer	Height in inches
`high_school`	`player`	String	High school attended ex. `Whitehouse (TX)`
`id`	`player`	GUID	Unique ID of a player ex. `11cad59d-90dd-449c-a839-dddaba4fe16c`
`in_game_status`	`player`	String	In-game status of a player updated in real-time `active`, `probable`, `questionable`, `doubtful`, `out`, `benched`, `unknown`
`jersey`	`player`	Integer	Jersey number of a player
`last_name`	`player`	String	Last name of a player ex. `Mahomes`
`name_suffix`	`player`	String	Suffix of a player ex. `Jr.`
`position`	`player`	String	Position of a player See our FAQ for a list of valid positions
`preferred_name`	`player`	String	Preferred name of a player
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:1129537`
`status`	`player`	String	Game status of a player `deactivated`, `dnp`(Did Not Play), `played`, `started` See our FAQ for more info on these player game statuses
`weight`	`player`	Decimal	Weight in lbs

Team Records

Team win-loss-tie data is added after a game moves to complete status. It is not present prior to or during a game.

Attribute	Parent Element	Type	Description
`losses`	`record`	Integer	Number of team losses year-to-date after a game
`ties`	`record`	Integer	Number of team ties year-to-date after a game
`wins`	`record`	Integer	Number of team wins year-to-date after a game

Coaches

Attribute	Parent Element	Type	Description
`first_name`	`home` / `away` - `coach`	String	First name of a coach ex. `Dennis`
`full_name`	`home` / `away` - `coach`	String	Full name of a coach ex. `Dennis Allen`
`id`	`home` / `away` - `coach`	GUID	Unique ID of a coach ex. `ef1b4704-0ce4-4977-a882-2b14413dd2d2`
`last_name`	`home` / `away` - `coach`	String	Last name of a coach ex. `Allen`
`name_suffix`	`home` / `away` - `coach`	String	Suffix of a coach ex. `Jr.`
`position`	`home` / `away` - `coach`	String	Type of coach ex. `Head Coach` or `Offensive Coordinator`

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Team alias ex. `MIN` (Minnesota)
`id`	`team`	GUID	Unique ID of a team ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`team`	String	Team market name ex. `Minnesota`
`name`	`team`	String	Team name ex. `Vikings`
`sr_id`	`team`	String	Unique Sportradar ID of a team ex. `sr:competitor:4324`

Venue

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `900 S 5th Street`
`capacity`	`venue`	Integer	Capacity of a venue ex. `72220`
`city`	`venue`	String	City of a venue ex. `Minneapolis`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `6a72e5ca-33d0-40af-8e6b-b32a4d3d9346`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `29.684735`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-95.410725`
`name`	`venue`	String	Name of a venue ex. `U.S. Bank Stadium`
`roof_type`	`venue`	String	Roof type of a venue `outdoor`, `dome`, `retractable_dome`
`sr_id`	`venue`	String	Unique Sportradar venue ID ex. `sr:venue:2402`
`state`	`venue`	String	State of a venue ex. `MN`
`surface`	`venue`	String	Surface type of a venue `turf`, `artificial`
`zip`	`venue`	Integer	ZIP code of a venue ex. `77054`