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
`used_challenges`	`away`	Integer	Away team challenges used
`clock`	`game`	String	Clock value of the game ex. `12:37`
`remaining_challenges`	`home`	Integer	Home team challenges remaining
`used_challenges`	`home`	Integer	Home team challenges used
`quarter`	`game`	Integer	Quarter number of the game

Game:

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Away team alias ex. `TCU` (Texas Christian University)
`id`	`away`	GUID	Unique ID of the away team ex. `a09e634d-39a8-4aa8-81a4-7337580a31f4`
`market`	`away`	String	Away team market name ex. `TCU`
`name`	`away`	String	Away team name ex. `Horned Frogs`
`cable`	`broadcast`	String	Number of a game's broadcast cable station ex. `822`
`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. (SEC vs. SEC)
`coverage`	`game`	String	Coverage level of a game `full`, `extended_boxscore`
`duration`	`game`	String	Duration of a game ex. `2:52`
`entry_mode`	`game`	String	Type of data entry for the game `LDE` (Live Data Entry)
`expected_latency`	`game`	Integer	The time in seconds a game is expected to be behind real-time play on the field, with possible values of 2, 10, 25, and 50. For example, a value of `10` indicates a game is 10 or more seconds behind real-time, but less than 25. Latency values are made available one day before gameday, though they are subject to change on gameday itself. `2`, `10`, `25`, `50`
`game_type`	`game`	String	Type of game `regular`, `conference_championship`, `bowl`, `playoff`
`alias`	`home`	String	Home team alias ex. `UGA` (University of Georgia)
`id`	`home`	GUID	Unique ID of the home team ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`market`	`home`	String	Home team market name ex. `Georgia`
`name`	`home`	String	Home team name ex. `Bulldogs`
`id`	`game`	GUID	Unique ID of a game ex. `c9686716-f48a-4667-996d-97639429d8c3`
`neutral_site`	`game`	Boolean	Signifies a game is held at a neutral site
`playoff_game_type`	`game`	String	Name of a playoff game type See our FAQ for a list of valid playoff game types
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like bowl games) 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:38354639`
`status`	`game`	String	Game status `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `postponed`, `delayed`, `suspended`, `flex-schedule`, `time-tbd` See our NCAAFB FAQ for game status descriptions
`title`	`game`	String	Game title ex. `CFP National 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. `ff53e5e4-10ef-4842-a0b7-b489956fa07e`
`name`	`season`	String	Name of the season `REG`
`type`	`season`	String	Type of the season `REG`
`year`	`season`	Integer	Year of the season
`id`	`week`	GUID	Unique week ID ex. `c5b272b0-388f-496d-ab6f-0a341b0a116b`
`sequence`	`week`	Integer	Week sequence number
`title`	`week`	String	Week title ex. `10`

Player:

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `S.Bennett`
`birth_place`	`player`	String	Birthplace of a player ex. `Blackshear, GA, USA`
`eiligibility`	`player`	String	Eligibility status of a player `FR` (Freshman), `SO` (Sophomore), `JR` (Junior), `SR` (Senior), `GR` (Graduate)
`first_name`	`player`	String	First name of a player ex. `Stetson`
`height`	`player`	Integer	Height in inches
`id`	`player`	GUID	Unique ID of a player ex. `4be48c57-4b7c-46ad-8535-445c195feda6`
`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. `Bennet`
`name`	`player`	String	Full name of a player ex. `Stetson Bennet`
`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
`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

Coaches:

Attribute	Parent Element	Type	Description
`first_name`	`home`/`away` - `coach`	String	First name of a coach ex. `Kirby`
`full_name`	`home`/`away` - `coach`	String	Full name of a coach ex. `Kirby Smart`
`id`	`home`/`away` - `coach`	GUID	Unique ID of a coach ex. `9c34ca07-cd05-48dc-ba4e-45b9df6078eb`
`last_name`	`home`/`away` - `coach`	String	Last name of a coach ex. `Smart`
`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`

Standings:

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

Team:

Attribute	Parent Element	Type	Description
`alias`	`home`/`away`	String	Team alias ex. `IOW` (University of Iowa)
`id`	`home`/`away`	GUID	Unique ID of a team ex. `a2ee495d-37c7-45ac-ac3d-d3a492a219c1`
`market`	`home`/`away`	String	Team market name ex. `Iowa`
`name`	`home`/`away`	String	Team name ex. `Hawkeyes`

Venue:

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `886 Stadium Drive`
`capacity`	`venue`	Integer	Capacity of a venue ex. `69250`
`city`	`venue`	String	City of a venue ex. `Iowa City`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `967ef86b-d0de-49b7-8984-61f95104d30d`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `41.6587`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-91.5511`
`name`	`venue`	String	Name of a venue ex. `Kinnick Stadium`
`roof_type`	`venue`	String	Roof type of a venue `outdoor`, `dome`, `retractable_dome`
`state`	`venue`	String	State of a venue ex. `IA`
`surface`	`venue`	String	Surface type of a venue `turf`, `artificial`, `outdoor`
`zip`	`venue`	Integer	ZIP code of a venue ex. `52242`