⏱️
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`
`full_name`	`official`	String	Full name of an official ex. `Larry Smith`
`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. `PHI` (Philadelphia)
`id`	`draft` - `team`	GUID	Unique ID of a draft team ex. `b786eb70-9677-11ec-9193-6b32ce92fd29`
`market`	`draft` - `team`	String	Draft team market name ex. `Philadelphia`
`name`	`draft` - `team`	String	Draft team name ex. `Stars`
`sr_id`	`draft` - `team`	String	Unique Sportradar ID of a draft team ex. `sr:competitor:882421`

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Away team alias ex. `NO` (New Orleans)
`id`	`away`	GUID	Unique ID of the away team ex. `51da96b0-9676-11ec-9ad0-d3ebe46bbb12`
`market`	`away`	String	Away team market name ex. `New Orleans`
`name`	`away`	String	Away team name ex. `Breakers`
`sr_id`	`away`	String	Unique Sportradar ID of the away team ex. `sr:competitor:882413`
`conference_game`	`game`	Boolean	Signifies an in-Conference matchup
`coverage`	`game`	String	Optional value that displays the coverage of a game ex. `full`
`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. `PIT`
`id`	`home`	GUID	Unique ID of the home team ex. `c8797380-9677-11ec-9193-6b32ce92fd29`
`market`	`home`	String	Home team market name ex. `Pittsburgh`
`name`	`home`	String	Home team name ex. `Maulers`
`sr_id`	`home`	String	Unique Sportradar ID of the home team ex. `sr:competitor:882423`
`id`	`game`	GUID	Unique ID of a game ex. `03aa477c-de6a-4d7a-90f4-97eed05f2e89`
`neutral_site`	`game`	Boolean	Signifies a game is held at a neutral site
`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`, `halftime`, `complete`, `closed`, `cancelled`, `delayed`, `suspended`, `postponed`, `time-tbd` See our USFL FAQ for game status descriptions
`title`	`game`	String	Game title ex. `USFL Championship`

League

Attribute	Parent Element	Type	Description
`id`	`season`	GUID	Unique season ID ex. `234f28d6-b9d7-4881-a890-30b451c13aec`
`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. `eb5f5b92-6a4e-42a7-b590-3f0ce7cc4736`
`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. `J.Crawford`
`age`	`player`	Integer	Age of a player at the time of the game
`birth_date`	`player`	Date	Player date of birth ex. `1994-12-02`
`birth_place`	`player`	String	Birthplace of a player ex. `Deerfield Beach, FL, USA`
`college`	`player`	String	College attended ex. `Illinois`
`college_conf`	`player`	String	College Conference ex. `Big Ten Conference`
`first_name`	`player`	String	First name of a player ex. `James`
`name`	`player`	String	Full name of a player ex. `James Crawford`
`height`	`player`	Integer	Height in inches
`high_school`	`player`	String	High school attended ex. `St. Thomas Aquinas (FL)`
`id`	`player`	GUID	Unique ID of a player ex. `94b1aa60-b862-11ec-8d8f-9baa1b88fba4`
`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. `Crawford`
`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
`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

Standings

Attribute	Parent Element	Type	Description
`losses`	`record`	Integer	Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome
`ties`	`record`	Integer	Number of team ties year-to-date before the game. Record is updated post-game based on the game outcome
`wins`	`record`	Integer	Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome

Coaches

Attribute	Parent Element	Type	Description
`first_name`	`home`/`away` - `coach`	String	First name of a coach ex. `John`
`full_name`	`home`/`away` - `coach`	String	Full name of a coach ex. `John DeFilippo`
`id`	`home`/`away` - `coach`	GUID	Unique ID of a coach ex. `80675d40-6102-11ed-a6fd-cb7b3f097b25`
`last_name`	`home`/`away` - `coach`	String	Last name of a coach ex. `DeFilippo`
`name_suffix`	`home`/`away` - `coach`	String	Suffix of a coach ex. `Jr.`
`position`	`home`/`away` - `coach`	String	Type of coach ex. `Head Coach`

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Team alias ex. `PIT`
`id`	`team`	GUID	Unique ID of a team ex. `c8797380-9677-11ec-9193-6b32ce92fd29`
`market`	`team`	String	Team market name ex. `Pittsburgh`
`name`	`team`	String	Team name ex. `Maulers`
`sr_id`	`team`	String	Unique Sportradar ID of a team ex. `sr:competitor:882423`

Venue

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `1020 24th St N`
`capacity`	`venue`	Integer	Capacity of a venue ex. `47100`
`city`	`venue`	String	City of a venue ex. `Birmingham`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `b1f3fd20-90f4-11ec-bf38-efe8ff3d0b79`
`name`	`venue`	String	Name of a venue ex. `Protective 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:58724`
`state`	`venue`	String	State of a venue ex. `AL`
`surface`	`venue`	String	Surface type of a venue `turf`, `artificial`
`zip`	`venue`	Integer	ZIP code of a venue ex. `35203`

200200