Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Team 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
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 4 hours

Data Updates: Updates in realtime as changes are made to rosters or player profiles


Data Points

Draft
AttributeParent ElementTypeDescription
numberplayer - draftIntegerDraft pick number of a player
roundplayer - draftIntegerDraft pick round of a player
yearplayer - draftIntegerDraft year of a player
aliasplayer - draft - teamStringDraft team alias

ex. MIN (Minnesota)
idplayer - draft - teamGUIDUnique ID of a draft team

ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketplayer - draft - teamStringDraft team market name

ex. Minnesota
nameplayer - draft - teamStringDraft team name

ex. Vikings
sr_idplayer - draft - teamStringUnique Sportradar ID of a draft team

ex. sr:competitor:4324
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
aliashierarchy - conferenceStringAlias of a conference

ex. AFC
idhierarchy - conferenceGUIDUnique ID of a conference

ex. 1bdefe12-6cb2-4d6a-b208-b04602ae79c3
namehierarchy - conferenceStringName of a conference

ex. AFC
aliashierarchy - divisionStringAlias of a division

ex. AFC AFC_WEST
idhierarchy - divisionGUIDUnique ID of a division

ex. 324decdd-aa1b-4074-8958-c009d8fac31a
namehierarchy - divisionStringName of a division

ex. AFC West
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. P.Mahomes
birth_dateplayerDatePlayer date of birth

ex. 1995-09-17
birth_placeplayerStringBirthplace of a player

ex. Tyler, TX, USA
collegeplayerStringCollege attended

ex. Texas Tech
college_confplayerStringCollege Conference

ex. Big Twelve
experienceplayerIntegerNumber of years active in the NFL for a player
first_nameplayerStringFirst name of a player

ex. Patrick
nameplayerStringFull name of a player

ex. Patrick Mahomes
heightplayerIntegerHeight in inches
high_schoolplayerStringHigh school attended

ex. Whitehouse (TX)
idplayerGUIDUnique ID of a player

ex. 11cad59d-90dd-449c-a839-dddaba4fe16c
jerseyplayerIntegerJersey number of a player
last_nameplayerStringLast name of a player

ex. Mahomes
name_suffixplayerStringSuffix of a player

ex. Jr.
positionplayerStringPosition of a player

See our FAQ for a list of valid positions
preferred_nameplayerStringPreferred name of a player
salaryplayerDecimalCurrent annual salary of a player

ex. 1255000
sr_idplayerGUIDUnique Sportradar ID of a player

ex. sr:player:1129537
statusplayerStringStatus of a player

ACT (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)
weightplayerDecimalWeight in lbs
Player - Reference

Use the reference field to link a player's NFL API profile to their NCAA Football API profile

AttributeParent ElementTypeDescription
id_typeplayer - referenceStringType of a player's linked player Id

ex. league_profile (League Player Id)
scopeplayer - referenceStringName of the league/API for a player's linked Id

ex. NCAAFB (NCAA Football API)
source_idplayer - referenceGUIDUnique player Id for a linked player profile

ex. 531fa6d3-9c8e-437b-8eca-8ca79bf12cc0 (Player Id within the NCAA Football API)
Coaches
AttributeParent ElementTypeDescription
first_namecoaches - coachStringFirst name of a coach

ex. Dennis
full_namecoaches - coachStringFull name of a coach

ex. Dennis Allen
idcoaches - coachGUIDUnique ID of a coach

ex. ef1b4704-0ce4-4977-a882-2b14413dd2d2
last_namecoaches - coachStringLast name of a coach

ex. Allen
name_suffixcoaches - coachStringSuffix of a coach

ex. Jr.
positioncoaches - coachStringType of coach

ex. Head Coach or Offensive Coordinator
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
required
Defaults to 0d855753-ea21-4953-89f9-0e20aff9eb73

Unique Id of a team, found in the Teams endpoint

Example: 0d855753-ea21-4953-89f9-0e20aff9eb73

Note: This endpoint is designed for team_ids which exist in the current League Hierarchy endpoint

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