Integration GuidesReference Docs
Coverage MatrixDocumentationRelease LogLog InContact Us

League Hierarchy

NFL League Hierarchy provides top-level information for each team, including conference and division distinction, venue information, and team colors.


Update Frequency

TTL / Cache: 300s

Data Updates: Hierarchy updates will appear as they are updated in the database

Data Points

AttributeParent ElementTypeDescription
aliasfranchiseStringFranchise (team) alias
ex. DEN (Denver Broncos)
idfranchiseGUIDUnique ID of a franchise
ex. 32e2db10-be6d-41ed-9e3d-5b30ba164b99
namefranchiseStringFranchise (team) name
ex. Broncos
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league
ex. NFL
idleagueGUIDUnique ID of a league
ex. 3c6d318a-6164-4290-9bbc-bf9bb21cc4b8
nameleagueStringName of a league
ex. National Football League
aliasconferenceStringAlias of a conference
ex. AFC
idconferenceGUIDUnique ID of a conference
ex. 1bdefe12-6cb2-4d6a-b208-b04602ae79c3
nameconferenceStringName of a conference
ex. AFC
aliasdivisionStringAlias of a division
iddivisionGUIDUnique ID of a division
ex. 324decdd-aa1b-4074-8958-c009d8fac31a
namedivisionStringName of a division
ex. AFC West
AttributeParent ElementTypeDescription
aliasteamStringTeam alias
ex. MIN (Minnesota)
championship_seasonsteamStringYears of championship (Super Bowls) seasons
ex. 1997, 1998, 2015
championships_wonteamIntegerNumber of championships (Super Bowls) won
conference_titlesteamIntegerNumber of conference titles
division_titlesteamIntegerNumber of division titles
fight_songteamStringTeam fight song
ex. Skol, Vikings
foundedteamIntegerYear a team was founded
general_managerteamStringTeam general manager
ex. Kwesi Adofo-Mensah
idteamGUIDUnique ID of a team
ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketteamStringTeam market name
ex. Minnesota
mascotteamStringTeam mascot
ex. Viktor the Viking
nameteamStringTeam name
ex. Vikings
nicknamesteamStringTeam nicknames
ex. The Vikes
ownerteamStringTeam owner
ex. Zygi Wilf
playoff_appearancesteamIntegerNumber of playoff appearances
presidentteamStringTeam president
ex. Mark Wilf
sr_idteamStringUnique Sportradar ID of a team
ex. sr:competitor:4324
alphateam_colorFloatTeam color Alpha value
ex. 0.0
hex_colorteam_colorStringTeam color HEX value
ex. #ffc62f
typeteam_colorStringType of team color
redteam_color - rgb-colorIntegerTeam RGB color code - Red
ex. 255
greenteam_color - rgb-colorIntegerTeam RGB color code - Green
ex. 198
blueteam_color - rgb-colorIntegerTeam RGB color code - Blue
ex. 47
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 900 S 5th Street
capacityvenueIntegerCapacity of a venue
ex. 72220
cityvenueStringCity of a venue
ex. Minneapolis
countryvenueStringCountry of a venue
ex. USA
idvenueGUIDUnique ID of a venue
ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346
latvenue - locationDecimalLatitude of a venue
ex. 29.684735
lngvenue - locationDecimalLongitude of a venue
ex. -95.410725
namevenueStringName of a venue
ex. U.S. Bank Stadium
roof_typevenueStringRoof type of a venue
sr_idvenueStringUnique Sportradar venue ID
ex. sr:venue:2402
statevenueStringState of a venue
ex. MN
surfacevenueStringSurface type of a venue
zipvenueIntegerZIP code of a venue
ex. 77054
Click Try It! to start a request and see the response here!