get https://api.sportradar.com/nfl/official//v7//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: As Necessary
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 colorprimary,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 venueoutdoor,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 venueturf,artificial |
zip | venue | Integer | ZIP code of a venue ex. 77054 |