Game Roster

Time	Status	User Agent
Retrieving recent requests…

⏱️
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
Recommended Pull (Non-Live): Pull on an as-needed basis. Feed can be ignored until around 90 minutes before the scheduled game start, when NFL teams announce inactive players. Click here for more info on player game statuses. Utilize the daily change log to capture data changes after a game has ended.
Recommended Pull (Live): Can request as fast as every 3 seconds (matching the TTL) when a game is live. Game feeds can be requested 90 minutes before the scheduled start.

📘
Retrieving Rosters and Players
Learn how to use the Game Roster for game-day player statuses in our Retrieving Rosters and Players integration scenario.

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)
`deleted`	`game`	Boolean	Signifies a game was deleted when `true`
`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`	String	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`

Update Frequency

Retrieving Rosters and Players

Data Points

200200