Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

League Hierarchy

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

Log in to see full request history

⏱️

Update Frequency

TTL / Cache: 300s

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


Data Points

Franchise:
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
League:
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
ex. AFC AFC_WEST
iddivisionGUIDUnique ID of a division
ex. 324decdd-aa1b-4074-8958-c009d8fac31a
namedivisionStringName of a division
ex. AFC West
Team:
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
primary,secondary
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
Venue:
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
outdoor,dome,retractable_dome
sr_idvenueStringUnique Sportradar venue ID
ex. sr:venue:2402
statevenueStringState of a venue
ex. MN
surfacevenueStringSurface type of a venue
turf,artificial
zipvenueIntegerZIP code of a venue
ex. 77054
Path Params
string
required
Defaults to trial

The access level of your API key

trial, production

string
required
Defaults to en

2-letter code for supported languages

br (Brazilian Portuguese), da (Danish), de (German), en (English), es (Spanish), fi (Finnish), fr (French), it (Italian), ja (Japanese), nl (Dutch), no (Norwegian), se (Swedish), tr (Turkish)

string
required
Defaults to json

Format returned

json, xml

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json