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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 4 hours

Data Updates: Hierarchy updates 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
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
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
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

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