get
https://api.sportradar.com/nfl/official//v7//players//profile.
NFL Player Profile provides player biographical information, draft information, and seasonal statistics.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache:
- 15 minutes for active players
- 30 minutes for retired players, free agents, and players with no status
Data Updates: Seasonal stats update around 5 minutes after a game moves to
closedRecommended Pull (Non-Live): Pull on an as-needed basis. Utilize the daily change log to capture data changes after a game has ended.
Recommended Pull (Live): Pull 5-10 mins after a game is moved to
closedto receive the quickest updates
Building Player ViewsLearn how to use the Player Profile for player bios and career statistics in our Retrieving Rosters and Players integration scenario.
Data Points
Draft
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
number | draft | Integer | Draft pick number of a player |
round | draft | Integer | Draft pick round of a player |
year | draft | Integer | Draft year of a player |
alias | draft - team | String | Draft team alias ex. MIN (Minnesota) |
id | draft - team | GUID | Unique ID of a draft team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
market | draft - team | String | Draft team market name ex. Minnesota |
name | draft - team | String | Draft team name ex. Vikings |
sr_id | draft - team | String | Unique Sportradar ID of a draft team ex. sr:competitor:4324 |
League
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | season | GUID | Unique season ID ex. 75749c10-56c1-4ae0-9d1e-2689708debdf |
name | season | String | Name of the seasonPRE, REG, PST |
type | season | String | Type of the seasonPRE, REG, PST |
year | season | Integer | Year of the season |
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 | Player 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 | String | 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 | Player 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) |
Season Statistics - Conversions
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
defense_attempts | season - team - statistics - conversions | Integer | Number of defensive two-point conversion attempts |
defense_successes | season - team - statistics - conversions | Integer | Number of successful defensive two-point conversions |
pass_attempts | season - team - statistics - conversions | Integer | Number of two-point conversion passing attempts |
pass_successes | season - team - statistics - conversions | Integer | Number of successful passing two-point conversions |
receiving_attempts | extra_points - conversions | Integer | Number of two-point conversion receiving attempts |
receiving_attempts | extra_points - conversions | Integer | Number of successful receiving two-point conversions |
rush_attempts | season - team - statistics - conversions | Integer | Number of two-point conversion rushing attempts |
rush_successes | season - team - statistics - conversions | Integer | Number of successful rushing two-point conversions |
Season Statistics - Defense
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
assists | season - team - statistics - defense | Integer | Number of defensive assisted tackles Does not include misc. or special teams tackles |
batted_passes | season - team - statistics - defense | Integer | Number of batted passes |
blitzes | season - team - statistics - defense | Integer | Number of blitzes |
combined | season - team - statistics - defense | Integer | Number of combined (assists + tackles) defensive tacklesDoes not include misc. or special teams tackles |
def_comps | season - team - statistics - defense | Integer | Number of completed passes with a defensive player covering on the play |
def_targets | season - team - statistics - defense | Integer | Number of defensive targets |
forced_fumbles | season - team - statistics - defense | Integer | Number of forced fumbles |
fumble_recoveries | season - team - statistics - defense | Integer | Number of fumble recoveries |
hurries | season - team - statistics - defense | Integer | Number of hurries |
interceptions | season - team - statistics - defense | Integer | Number of interceptions |
knockdowns | season - team - statistics - defense | Integer | Number of knockdowns |
misc_assists | season - team - statistics - defense | Integer | Number of miscellaneous assisted tackles. Ex: An assisted tackle by an offensive player on a defensive interception or fumble return |
misc_forced_fumbles | season - team - statistics - defense | Integer | Number of miscellaneous forced fumbles. Ex: A forced fumble by an offensive player on a defensive interception or fumble return |
misc_fumble_recoveries | season - team - statistics - defense | Integer | Number of miscellaneous fumble recoveries. Ex: A fumble recovery by an offensive player on a defensive interception or fumble return |
misc_tackles | season - team - statistics - defense | Integer | Number of miscellaneous tackles. Ex: A solo tackle by an offensive player on a defensive interception or fumble return |
missed_tackles | season - team - statistics - defense | Integer | Number of missed tackles |
passes_defended | season - team - statistics - defense | Integer | Number of passes defended |
qb_hits | season - team - statistics - defense | Integer | Number of hits on the quarterback |
sack_yards | season - team - statistics - defense | Decimal | Number of sack yards Sack yardage can include halves when players share a sack |
sacks | season - team - statistics - defense | Decimal | Number of sacks Defensive players can be credited half a sack, so values can include halves (e.g. 0.5) |
safeties | season - team - statistics - defense | Integer | Number of safeties |
sp_assists | season - team - statistics - defense | Integer | Number of special teams assisted tackles |
sp_blocks | season - team - statistics - defense | Integer | Number of blocked kicks/punts |
sp_forced_fumbles | season - team - statistics - defense | Integer | Number of special teams forced fumbles |
sp_fumble_recoveries | season - team - statistics - defense | Integer | Number of total (kicking + receiving) special teams fumble recoveries |
sp_opp_fumble_recoveries | season - team - statistics - defense | Integer | Number of special teams opponent fumble recoveries |
sp_own_fumble_recoveries | season - team - statistics - defense | Integer | Number of own special teams fumble recoveries |
sp_tackles | season - team - statistics - defense | Integer | Number of special teams tackles |
tackles | season - team - statistics - defense | Integer | Number of defensive tackles Does not include misc. or special teams tackles |
three_and_outs_forced | season - team - statistics - defense | Integer | Number of three and outs forced |
tloss | season - team - statistics - defense | Decimal | Number of tackles for a loss |
tloss_yards | season - team - statistics - defense | Decimal | Number of tackles for a loss yardage |
Season Statistics - Extra Points
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
attempts | season - team - statistics- extra_points | Integer | Number of attempted extra points |
blocked | season - team - statistics- extra_points | Integer | Number of blocked extra points |
made | season - team - statistics- extra_points | Integer | Number of made extra points |
missed | season - team - statistics- extra_points | Integer | Number of missed extra points |
percent | season - team - statistics- extra_points | Decimal | Extra point percentage ex. 75.0 |
Season Statistics - Field Goals
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
attempts | season - team - statistics - field_goals | Integer | Number of attempted field goals |
attempts_19 | season - team - statistics - field_goals | Integer | Number of attempted field goals between 1-19 yards |
attempts_29 | season - team - statistics - field_goals | Integer | Number of attempted field goals between 20-29 yards |
attempts_39 | season - team - statistics - field_goals | Integer | Number of attempted field goals between 30-39 yards |
attempts_49 | season - team - statistics - field_goals | Integer | Number of attempted field goals between 40-49 yards |
attempts_50 | season - team - statistics - field_goals | Integer | Number of attempted field goals of 50 yards or more |
avg_yards | season - team - statistics - field_goals | Decimal | Average number of yards on attempted field goals ex. 38.5 |
blocked | season - team - statistics - field_goals | Integer | Number of blocked field goals |
longest | season - team - statistics - field_goals | Integer | Number of yards of longest made field goal |
made | season - team - statistics - field_goals - player | Integer | Number of made field goals |
made_19 | season - team - statistics - field_goals | Integer | Number of successful field goals between 1-19 yards |
made_29 | season - team - statistics - field_goals | Integer | Number of successful field goals between 20-29 yards |
made_39 | season - team - statistics - field_goals | Integer | Number of successful field goals between 30-39 yards |
made_49 | season - team - statistics - field_goals | Integer | Number of successful field goals between 40-49 yards |
made_50 | season - team - statistics - field_goals | Integer | Number of successful field goals of 50 yards or more |
missed | season - team - statistics - field_goals | Integer | Number of missed field goals |
pct | season - team - statistics - field_goals | Decimal | Field goal percentage ex. 75.0 |
yards | season - team - statistics - field_goals | Integer | Number of total yards on successful field goals |
Season Statistics - Fumbles
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
ez_rec_tds | season - team - statistics - fumbles | Integer | Number of end zone fumble recovery touchdowns |
forced_fumbles | season - team - statistics - fumbles | Integer | Number of forced fumbles |
fumbles | season - team - statistics - fumbles | Integer | Number of fumbles |
lost_fumbles | season - team - statistics - fumbles | Integer | Number of lost fumbles |
opp_rec | season - team - statistics - fumbles | Integer | Number of opponent fumble recoveries |
opp_rec_tds | season - team - statistics - fumbles | Integer | Number of opponent fumble recovery touchdowns |
opp_rec_yards | season - team - statistics - fumbles | Integer | Number of opponent fumble recovery yards |
out_of_bounds | season - team - statistics - fumbles | Integer | Number of opponent fumbles out of bounds |
own_rec | season - team - statistics - fumbles | Integer | Number of own fumble recoveries |
own_rec_tds | season - team - statistics - fumbles | Integer | Number of own fumble recovery touchdowns |
own_rec_yards | season - team - statistics - fumbles | Integer | Number of own fumble recovery yards |
Season Statistics - Interception Returns
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
avg_yards | season - team - statistics - int_returns | Decimal | Average number of yards on interception returns ex. 38.5 |
longest | season - team - statistics - int_returns | Integer | Number of yards of longest interception return |
longest_touchdown | season - team - statistics - int_returns | Integer | Number of yards of longest interception return for a touchdown |
returns | season - team - statistics - int_returns | Integer | Number of interception returns |
touchdowns | season - team - statistics - int_returns | Integer | Number of interception return touchdowns |
yards | season - team - statistics - int_returns | Integer | Number of total interception return yards |
Season Statistics - Kick Returns
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
avg_yards | season - team - statistics - kick_returns | Decimal | Average number of yards on kick returns ex. 19.5 |
faircatches | season - team - statistics - kick_returns | Integer | Number of fair catches on kick returns |
longest | season - team - statistics - kick_returns | Integer | Number of yards of longest kick return |
longest_touchdown | season - team - statistics - kick_returns | Integer | Number of yards of longest kick return for a touchdown |
returns | season - team - statistics - kick_returns | Integer | Number of kick returns |
touchdowns | season - team - statistics - kick_returns | Integer | Number of kick return touchdowns |
yards | season - team - statistics - kick_returns | Integer | Number of total kick return yards |
Season Statistics - Kickoffs
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
endzone | season - team - statistics - kickoffs | Integer | Number of kickoffs into the endzone |
inside_20 | season - team - statistics - kickoffs | Integer | Number of kickoffs inside the 20 yardline |
kickoffs | season - team - statistics - kickoffs | Integer | Number of kickoffs |
onside_attempts | season - team - statistics - kickoffs | Integer | Number of onside kickoff attempts |
onside_successes | season - team - statistics - kickoffs | Integer | Number of onside kickoff successes |
out_of_bounds | season - team - statistics - kickoffs | Integer | Number of kickoffs out of bounds |
return_yards | season - team - statistics - kickoffs | Integer | Number of total return yards on kickoffs |
squib_kicks | season - team - statistics - kickoffs | Integer | Number of squib kicks |
touchbacks | season - team - statistics - kickoffs | Integer | Number of touchbacks |
yards | season - team - statistics - kickoffs | Integer | Number of kickoff yards |
Season Statistics - Passing
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
air_yards | season - team - statistics - passing | Integer | Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) |
attempts | season - team - statistics - passing | Integer | Number of pass attempts |
avg_pocket_time | season - team - statistics - passing | Double | Average time spent in the pocket ex. 2.477 |
avg_yards | season - team - statistics - passing | Decimal | Average yards per pass attempt ex. 7.22 |
batted_passes | season - team - statistics - passing | Integer | Number of batted pass attempts |
blitzes | season - team - statistics - passing | Integer | Number of blitzes |
cmp_pct | season - team - statistics - passing | Decimal | Completion percentage ex. 78.049 |
completions | season - team - statistics - passing | Integer | Number of pass completions |
defended_passes | season - team - statistics - passing | Integer | Number of pass attempts defended |
dropped_passes | season - team - statistics - passing | Integer | Number of pass attempts dropped |
first_downs | season - team - statistics - passing | Integer | Number of first downs |
gross_yards | season - team - statistics - passing | Integer | Number of gross yards passing Gross yards does not deduct sack yardage from the total |
hurries | season - team - statistics - passing | Integer | Number of pass hurries |
interceptions | season - team - statistics - passing | Integer | Number of interceptions thrown |
int_touchdowns | season - team - statistics - passing | Integer | Number of interceptions thrown returned for touchdowns |
knockdowns | season - team - statistics - passing | Integer | Number of knockdowns |
longest | season - team - statistics - passing | Integer | Number of yards of longest completed pass |
longest_touchdown | season - team - statistics - passing | Integer | Number of yards of longest pass for a touchdown |
net_yards | season - team - statistics - passing | Integer | Number of net yards passing Net yards deducts sack yardage from the total |
on_target_throws | season - team - statistics - passing | Integer | Number of on target throws |
pocket_time | season - team - statistics - passing | Double | Time spent in the pocket ex. 101.573 |
poor_throws | season - team - statistics - passing | Integer | Number of poor throws |
rating | season - team - statistics - passing | Decimal | Passer rating ex. 94.7 |
redzone_attempts | season - team - statistics - passing | Integer | Number of pass attempts in the red zone |
sack_yards | season - team - statistics - passing | Integer | Number of sack yards |
sacks | season - team - statistics - passing | Integer | Number of sacks |
spikes | season - team - statistics - passing | Integer | Number of spikes |
throw_aways | season - team - statistics - passing | Integer | Number of throw aways |
touchdowns | season - team - statistics - passing | Integer | Number of passing touchdowns |
yards | season - team - statistics - passing | Integer | Number of passing yards |
Season Statistics - Penalties
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
first_downs | season - team - statistics - penalties | Integer | Number of penalties resulting in a first down |
penalties | season - team - statistics - penalties | Integer | Number of penalties |
yards | season - team - statistics - penalties | Integer | Number of penalty yardage |
Season Statistics - Punt Returns
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
avg_yards | season - team - statistics - punt_returns | Decimal | Average number of yards on punt returns ex. 19.5 |
faircatches | season - team - statistics - punt_returns | Integer | Number of fair catches on punt returns |
longest | season - team - statistics - punt_returns | Integer | Number of yards of longest punt return |
longest_touchdown | season - team - statistics - punt_returns | Integer | Number of yards of longest punt return for a touchdown |
returns | season - team - statistics - punt_returns | Integer | Number of punt returns |
touchdowns | season - team - statistics - punt_returns | Integer | Number of punt return touchdowns |
yards | season - team - statistics - punt_returns | Integer | Number of total punt return yards |
Season Statistics - Punts
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
attempts | season - team - statistics - punts | Integer | Number of punt attempts |
avg_hang_time | season - team - statistics - punts | Double | Average hang time on punts ex. 4.163 |
avg_net_yards | season - team - statistics - punts | Decimal | Average net yards on punts ex. 28.75 |
avg_yards | season - team - statistics - punts | Decimal | Average yards on punts ex. 43.75 |
blocked | season - team - statistics - punts | Integer | Number of punts blocked |
hang_time | season - team - statistics - punts | Double | Total hang time on punts ex. 16.65 |
inside_20 | season - team - statistics - punts | Integer | Number of punts inside the 20 yardline |
longest | season - team - statistics - punts | Integer | Number of yards of longest punt |
net_yards | season - team - statistics - punts | Integer | Number of total net punt yards |
return_yards | season - team - statistics - punts | Integer | Number of total return punt yards |
touchbacks | season - team - statistics - punts | Integer | Number of touchbacks |
yards | season - team - statistics - punts | Integer | Number of punt yards |
Season Statistics - Receiving
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
air_yards | season - team - statistics - receiving | Integer | Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) |
avg_yards | season - team - statistics - receiving | Decimal | Average yards per reception ex. 7.22 |
broken_tackles | season - team - statistics - receiving | Integer | Number of receiving broken tackles |
catchable_passes | season - team - statistics - receiving | Integer | Number of catchable passes |
dropped_passes | season - team - statistics - receiving | Integer | Number of dropped passes |
first_downs | season - team - statistics - receiving | Integer | Number of receiving first downs |
longest | season - team - statistics - receiving | Integer | Number of yards of longest reception |
longest_touchdown | season - team - statistics - receiving | Integer | Number of yards of longest receiving touchdown |
receptions | season - team - statistics - receiving | Integer | Number of receptions |
redzone_targets | season - team - statistics - receiving | Integer | Number of receiving red zone targets |
targets | season - team - statistics - receiving | Integer | Number of receiving targets |
touchdowns | season - team - statistics - receiving | Integer | Number of receiving touchdowns |
yards | season - team - statistics - receiving | Integer | Number of receiving yards |
yards_after_catch | season - team - statistics - receiving | Integer | Number of receiving yards after the catch |
yards_after_contact | receive - player | Integer | Number of receiving yards after contact |
Season Statistics - Rushing
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
attempts | season - team - statistics - rushing | Integer | Number of rushing attempts |
avg_yards | season - team - statistics - rushing | Decimal | Average yards per rush ex. 3.22 |
broken_tackles | season - team - statistics - rushing | Integer | Number of rushing broken tackles |
first_downs | season - team - statistics - rushing | Integer | Number of rushing first downs |
kneel_downs | season - team - statistics - rushing | Integer | Number of rushing kneel downs |
longest | season - team - statistics - rushing | Integer | Number of yards of longest rush |
longest_touchdown | season - team - statistics - rushing | Integer | Number of yards of longest rushing touchdown |
redzone_attempts | season - team - statistics - rushing | Integer | Number of rushing red zone attempts |
scrambles | season - team - statistics - rushing | Integer | Number of rushing scrambles |
tlost | season - team - statistics - rushing | Integer | Number of rushing tackles for a loss |
tlost_yards | season - team - statistics - rushing | Integer | Number of rushing tackles for a loss yardage |
touchdowns | season - team - statistics - rushing | Integer | Number of rushing touchdowns |
yards | season - team - statistics - rushing | Integer | Number of rushing yards |
yards_after_contact | season - team - statistics - rushing | Integer | Number of rushing yards after contact |
Season Statistics - Games Played & Started
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
games_played | statistics | Integer | Number of games played |
games_started | statistics | Integer | Number of games started |
Team
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | team | String | Team alias ex. MIN (Minnesota) |
id | team | GUID | Unique ID of a team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
market | team | String | Team market name ex. Minnesota |
name | team | String | Team name ex. Vikings |
sr_id | team | String | Unique Sportradar ID of a team ex. sr:competitor:4324 |
