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

Data Points

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`

Franchise

Attribute	Parent Element	Type	Description
`alias`	`franchise`	String	Franchise (team) alias ex. `NJ` (New Jersey Generals)
`id`	`franchise`	GUID	Unique ID of a franchise ex. `ad96d260-9677-11ec-9ad0-d3ebe46bbb12`
`name`	`franchise`	String	Franchise (team) name ex. `Generals`

League

Attribute	Parent Element	Type	Description
`alias`	`hierarchy` - `conference`	String	Alias of a conference ex. `UFL`
`id`	`hierarchy` - `conference`	GUID	Unique ID of a conference ex. `23f26d00-966b-11ec-aba0-0f22e7db39c9`
`name`	`hierarchy` - `conference`	String	Name of a conference ex. `UFL`
`alias`	`hierarchy` - `division`	String	Alias of a division ex. `XFL`
`id`	`hierarchy` - `division`	GUID	Unique ID of a division ex. `cf16ca01-9675-11ec-b3cb-77bc504b6aa0`
`name`	`hierarchy` - `division`	String	Name of a division ex. `XFL Conference`
`id`	`season`	GUID	Unique season ID ex. `234f28d6-b9d7-4881-a890-30b451c13aec`

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `J.Crawford`
`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`
`experience`	`player`	Integer	Number of years active in the UFL for a player
`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`
`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	Status of a player `ACT`(Active), `DUP`(Duplicate profile), `EXE`(Exempt), `IR`(Injured Reserve), `IRD`(Injured Reserve - Designated for Return), `NON`(Non-football related injured reserve), `NWT`(Not with team), `PRA`(Practice Squad), `PUP`(Physically unable to perform), `RET`(Retired), `SUS`(Suspended), `UDF`(Unsigned draft pick)
`weight`	`player`	Decimal	Weight in lbs

Player - Reference

Use the reference field to link a player's UFL 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`	`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. `SA`
`championship_seasons`	`team`	String	Years of championship seasons ex. `2022, 2023`
`championships_won`	`team`	Integer	Number of championships won
`conference_titles`	`team`	Integer	Number of conference titles
`division_titles`	`team`	Integer	Number of division titles
`founded`	`team`	Integer	Year a team was founded
`fight_song`	`team`	String	Team fight song
`general_manager`	`team`	String	Team general manager ex. `Lonnie Young`
`id`	`team`	GUID	Unique ID of a team ex. `c8797380-9677-11ec-9193-6b32ce92fd29`
`market`	`team`	String	Team market name ex. `San Antonio`
`mascot`	`team`	String	Team mascot ex. `Marty the Mauler`
`name`	`team`	String	Team name ex. `Brahmas`
`nicknames`	`team`	String	Team nicknames
`owner`	`team`	String	Team owner ex. `National Spring Football League Enterprises`
`playoff_appearances`	`team`	Integer	Number of playoff appearances
`president`	`team`	String	Team president
`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`
`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. `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