get
https://api.sportradar.com/nfl/official//v7//teams//profile.
NFL Team Profile provides franchise team information, as well as a roster of active players.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 4 hours
Data Updates: Updates in realtime as changes are made to rosters or player profiles
Managing RostersLearn how to use the Team Profile for team details and current roster context in our Rosters and Players integration scenario.
Data Points
Draft
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
number | player - draft | Integer | Draft pick number of a player |
round | player - draft | Integer | Draft pick round of a player |
year | player - draft | Integer | Draft year of a player |
alias | player - draft - team | String | Draft team alias ex. MIN (Minnesota) |
id | player - draft - team | GUID | Unique ID of a draft team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
market | player - draft - team | String | Draft team market name ex. Minnesota |
name | player - draft - team | String | Draft team name ex. Vikings |
sr_id | player - draft - team | String | Unique Sportradar ID of a draft team ex. sr:competitor:4324 |
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 | hierarchy - conference | String | Alias of a conference ex. AFC |
id | hierarchy - conference | GUID | Unique ID of a conference ex. 1bdefe12-6cb2-4d6a-b208-b04602ae79c3 |
name | hierarchy - conference | String | Name of a conference ex. AFC |
alias | hierarchy - division | String | Alias of a division ex. AFC AFC_WEST |
id | hierarchy - division | GUID | Unique ID of a division ex. 324decdd-aa1b-4074-8958-c009d8fac31a |
name | hierarchy - division | String | Name of a division ex. AFC West |
Player
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr_name | player | String | Abbreviated name of a player ex. P.Mahomes |
birth_date | player | Date | Player date of birth ex. 1995-09-17 |
birth_place | player | String | Birthplace of a player ex. Tyler, TX, USA |
college | player | String | College attended ex. Texas Tech |
college_conf | player | String | College Conference ex. Big Twelve |
experience | player | Integer | Number of years active in the NFL for a player |
first_name | player | String | First name of a player ex. Patrick |
name | player | String | Full name of a player ex. Patrick Mahomes |
height | player | Integer | Height in inches |
high_school | player | String | High school attended ex. Whitehouse (TX) |
id | player | GUID | Unique ID of a player ex. 11cad59d-90dd-449c-a839-dddaba4fe16c |
jersey | player | Integer | Jersey number of a player |
last_name | player | String | Last name of a player ex. Mahomes |
name_suffix | player | String | Suffix of a player ex. Jr. |
position | player | String | Position of a player See our FAQ for a list of valid positions |
preferred_name | player | String | Preferred name of a player |
salary | player | Decimal | Current annual salary of a player ex. 1255000 |
sr_id | player | GUID | Unique Sportradar ID of a player ex. sr:player:1129537 |
status | player | String | Status of a playerACT (Active), DUP (Duplicate Profile), EXE (Exempt), FRES (Reserve/Future), IR (Injured Reserve), IRD (Injured Reserve - Designated for Return), NON (Non-football related injured reserve), NWT (Not with team), PRA(Practice Squad), PRA_IR (Practice Squad Injured Reserve), PUP (Physically unable to perform), RET (Retired), SUS (Suspended), UDF (Unsigned draft pick), UFA (Unsigned free agent) |
weight | player | Decimal | Weight in lbs |
Player - Reference
Use the
referencefield to link a player's NFL API profile to their NCAA Football API profile
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id_type | player - reference | String | Type of a player's linked player Id ex. league_profile (League Player Id) |
scope | player - reference | String | Name of the league/API for a player's linked Id ex. NCAAFB (NCAA Football API) |
source_id | player - reference | GUID | Unique player Id for a linked player profile ex. 531fa6d3-9c8e-437b-8eca-8ca79bf12cc0 (Player Id within the NCAA Football API) |
Coaches
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
first_name | coaches - coach | String | First name of a coach ex. Dennis |
full_name | coaches - coach | String | Full name of a coach ex. Dennis Allen |
id | coaches - coach | GUID | Unique ID of a coach ex. ef1b4704-0ce4-4977-a882-2b14413dd2d2 |
last_name | coaches - coach | String | Last name of a coach ex. Allen |
name_suffix | coaches - coach | String | Suffix of a coach ex. Jr. |
position | coaches - coach | String | Type of coach ex. Head Coach or Offensive Coordinator |
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 |