League Hierarchy

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Hierarchy updates appear as they are updated in the database

📘
Resolving League Structure
Learn how to use the League Hierarchy to resolve conference, division, and team IDs in our ID Handling guide.

Data Points

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`	`league`	String	Alias of a league ex. `NFL`
`id`	`league`	GUID	Unique ID of a league ex. `3c6d318a-6164-4290-9bbc-bf9bb21cc4b8`
`name`	`league`	String	Name of a league ex. `National Football League`
`alias`	`conference`	String	Alias of a conference ex. `AFC`
`id`	`conference`	GUID	Unique ID of a conference ex. `1bdefe12-6cb2-4d6a-b208-b04602ae79c3`
`name`	`conference`	String	Name of a conference ex. `AFC`
`alias`	`division`	String	Alias of a division ex. `AFC AFC_WEST`
`id`	`division`	GUID	Unique ID of a division ex. `324decdd-aa1b-4074-8958-c009d8fac31a`
`name`	`division`	String	Name of a division ex. `AFC West`

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`