get https://api.sportradar.com/nfl/official//v7//players//profile.
NFL Player Profile provides player biographical information, draft information, and seasonal statistics.
Update Frequency
TTL / Cache: 120 seconds
Data Updates: Seasonal stats are update on a 5 minute timer after a game is moved to
closed
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 | 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 | 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 tackles*Does 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 |
sacks | season - team - statistics - defense | Decimal | Number of sacks |
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 |