⏱️
Update Frequency
TTL / Cache: 300 seconds
Data Updates: Updates are made in realtime as changes are made to rosters or player profiles

Data Points

Draft

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

Franchise

Attribute	Parent Element	Type	Description
`alias`	`franchise`	String	Franchise (team) alias ex. `DEN` (Denver Broncos)
`id`	`franchise`	GUID	Unique ID of a franchise ex. `32e2db10-be6d-41ed-9e3d-5b30ba164b99`
`name`	`franchise`	String	Franchise (team) name ex. `Broncos`

League

Attribute	Parent Element	Type	Description
`alias`	`hierarchy` - `conference`	String	Alias of a conference ex. `AFC`
`id`	`hierarchy` - `conference`	GUID	Unique ID of a conference ex. `1bdefe12-6cb2-4d6a-b208-b04602ae79c3`
`name`	`hierarchy` - `conference`	String	Name of a conference ex. `AFC`
`alias`	`hierarchy` - `division`	String	Alias of a division ex. `AFC AFC_WEST`
`id`	`hierarchy` - `division`	GUID	Unique ID of a division ex. `324decdd-aa1b-4074-8958-c009d8fac31a`
`name`	`hierarchy` - `division`	String	Name of a division ex. `AFC West`

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `P.Mahomes`
`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`
`experience`	`player`	Integer	Number of years active in the NFL for a player
`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`
`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
`salary`	`player`	Decimal	Current annual salary of a player ex. `1255000`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:1129537`
`status`	`player`	String	Status of a player `ACT` (Active), `DUP` (Duplicate Profile), `EXE` (Exempt), `FRES` (Reserve/Future), `IR` (Injured Reserve), `IRD` (Injured Reserve - Designated for Return), `NON` (Non-football related injured reserve), `NWT` (Not with team), `PRA`(Practice Squad), `PRA_IR` (Practice Squad Injured Reserve), `PUP` (Physically unable to perform), `RET` (Retired), `SUS` (Suspended), `UDF` (Unsigned draft pick), `UFA` (Unsigned free agent)
`weight`	`player`	Decimal	Weight in lbs

Player - Reference

Use the reference field to link a player's NFL API profile to their NCAA Football API profile

Attribute	Parent Element	Type	Description
`id_type`	`player` - `reference`	String	Type of a player's linked player Id ex. `league_profile` (League Player Id)
`scope`	`player` - `reference`	String	Name of the league/API for a player's linked Id ex. `NCAAFB` (NCAA Football API)
`source_id`	`player` - `reference`	GUID	Unique player Id for a linked player profile ex. `531fa6d3-9c8e-437b-8eca-8ca79bf12cc0` (Player Id within the NCAA Football API)

Coaches

Attribute	Parent Element	Type	Description
`first_name`	`coaches` - `coach`	String	First name of a coach ex. `Dennis`
`full_name`	`coaches` - `coach`	String	Full name of a coach ex. `Dennis Allen`
`id`	`coaches` - `coach`	GUID	Unique ID of a coach ex. `ef1b4704-0ce4-4977-a882-2b14413dd2d2`
`last_name`	`coaches` - `coach`	String	Last name of a coach ex. `Allen`
`name_suffix`	`coaches` - `coach`	String	Suffix of a coach ex. `Jr.`
`position`	`coaches` - `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)
`championship_seasons`	`team`	String	Years of championship (Super Bowls) seasons ex. `1997, 1998, 2015`
`championships_won`	`team`	Integer	Number of championships (Super Bowls) won
`conference_titles`	`team`	Integer	Number of conference titles
`division_titles`	`team`	Integer	Number of division titles
`fight_song`	`team`	String	Team fight song ex. `Skol, Vikings`
`founded`	`team`	Integer	Year a team was founded
`general_manager`	`team`	String	Team general manager ex. `Kwesi Adofo-Mensah`
`id`	`team`	GUID	Unique ID of a team ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`team`	String	Team market name ex. `Minnesota`
`mascot`	`team`	String	Team mascot ex. `Viktor the Viking`
`name`	`team`	String	Team name ex. `Vikings`
`nicknames`	`team`	String	Team nicknames ex. `The Vikes`
`owner`	`team`	String	Team owner ex. `Zygi Wilf`
`playoff_appearances`	`team`	Integer	Number of playoff appearances
`president`	`team`	String	Team president ex. `Mark Wilf`
`sr_id`	`team`	String	Unique Sportradar ID of a team ex. `sr:competitor:4324`
`alpha`	`team_color`	Float	Team color Alpha value ex. `0.0`
`hex_color`	`team_color`	String	Team color HEX value ex. `#ffc62f`
`type`	`team_color`	String	Type of team color `primary`,`secondary`
`red`	`team_color` - `rgb-color`	Integer	Team RGB color code - Red ex. `255`
`green`	`team_color` - `rgb-color`	Integer	Team RGB color code - Green ex. `198`
`blue`	`team_color` - `rgb-color`	Integer	Team RGB color code - Blue ex. `47`

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`