Player Profile

⏱️
Update Frequency
TTL / Cache: 2 seconds
Data Updates: As Necessary

Data Points

Draft Info

Attribute	Parent Element	Type	Description
`pick`	`draft`	Integer	Draft pick number of a player
`round`	`draft`	Integer	Draft pick round of a player
`team_id`	`draft`	Integer	Unique ID of a draft team ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c`
`year`	`draft`	Integer	Draft year of a player

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NBDL`
`id`	`league`	GUID	Unique ID of a league ex. `ac79301f-9b1a-4e72-a4cb-230d4418ae08`
`name`	`league`	String	Name of a league ex. `NBA G League`
`id`	`season`	GUID	Unique ID of a season ex. `2a29bf58-7069-4ca4-8933-0347544e243d`
`type`	`season`	String	Type of a season `REG` (Regular Season)
`year`	`season`	Integer	Year of a season

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `J.Jackson`
`birth_date`	`player`	Date	Player date of birth ex. `1995-03-28`
`birth_place`	`player`	String	Birthplace of a player ex. `Houston, TX, USA`
`college`	`player`	String	College attended ex. `North Carolina`
`experience`	`player`	unsignedByte	Number of years played in the NBA
`first_name`	`player`	String	First name of a player ex. `Justin`
`full_name`	`player`	String	Full name of a player ex. `Justin Jackson`
`height`	`player`	unsignedByte	Height in inches
`high_school`	`player`	String	High school attended ex. `Homeschool Christian Youth (TX)`
`id`	`player`	GUID	Unique player ID ex. `fd1b8de8-1ea6-446e-9a86-a89bc28ae510`
`jersey_number`	`player`	Integer	Number of a player's jersey
`last_name`	`player`	String	Last name of a player ex. `Jackson`
`position`	`player`	String	Position of a player `NA`, `C`, `C-F`, `F`, `F-C`, `F-G`, `G`, `G-F`
`primary_position`	`player`	String	Primary position of a player `NA`, `C`, `PF`, `PG`, `SF`, `SG`
`status`	`player`	String	Status of a player `ACT` (Active), `SUS` (Suspended), `IR` (Injured Reserve), `TWO-WAY` (Two-Way Contract / D-League), `NWT` (Not with Team), `FA` (Free Agent), `RET` (Retired), `DUP` (Duplicate player profile)
`updated`	`player`	dateTime	Timestamp of a change to a player profile ex. `2022-09-30T22:55:57Z`
`weight`	`player`	unsignedShort	Weight in lbs.

Player Reference

Use the reference field to link a player's NBA API profile to their NCAA Men's Basketball API or NBA G League 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), `external` (NBA official `reference` Id), `sport_profile` (League-Specific API Id, synched across NBA, NCAAMB, and G League APIs)
`scope`	`player` - `reference`	String	Name of the league/API for a player's linked Id ex. `NCAAMB` (NCAA Men's Basketball API), `NBDL` (NBA G League API), `NBA` (NBA official `reference` Id), `basketball` (Player "parent" Id entry for League-Specific Sport APIs)
`source_id`	`player` - `reference`	GUID	Unique player Id for a linked player profile ex. `531fa6d3-9c8e-437b-8eca-8ca79bf12cc0` (Player Id within the NCAA Men's Basketball API or G League API), `1630545` (NBA official `reference` Id)

Player Statistics (Season) - Totals

Attribute	Parent Element	Type	Description
`assists`	`statistics` - `total`	Integer	Number of assists
`assists_turnover_ratio`	`statistics` - `total`	Decimal	Assist to turnover ratio
`blocked_att`	`statistics` - `total`	Integer	Number of blocked attempts
`blocks`	`statistics` - `total`	Integer	Number of shots blocked
`coach_ejections`	`statistics` - `total`	Integer	Number of coach ejections
`coach_tech_fouls`	`statistics` - `total`	Integer	Number of coach technical fouls
`defensive_rebounds`	`statistics` - `total`	Integer	Number of defensive rebounds
`double_doubles`	`statistics` - `total`	Integer	Number of double-doubles
`effective_fg_pct`	`statistics` - `total`	Decimal	Effective Field Goal Percentage (FG + 0.5 × 3P) / FGA
`efficiency`	`statistics` - `total`	Decimal	Player Efficiency Rating (sPoints + sAssists + sBlocks + sSteals + sFoulsDrawn + sReboundsTotal) - (sTurnovers + sBlocksReceived + sFoulsPersonal + sFoulsTechnical + (sTwoPointersAttempted - sTwoPointersMade) + (sThreePointersAttempted - sThreePointersMade) + (sFreeThrowsAttempted - sFreeThrowsMade))
`ejections`	`statistics` - `total`	Integer	Number of ejections
`fast_break_att`	`statistics` - `total`	Integer	Number of fast break attempts
`fast_break_made`	`statistics` - `total`	Integer	Number of fast break baskets
`fast_break_pct`	`statistics` - `total`	Decimal	Fast break percentage e.g. `100.0`
`fast_break_pts`	`statistics` - `total`	Integer	Number of fast break points
`field_goals_att`	`statistics` - `total`	Integer	Number of field goal attempts
`field_goals_made`	`statistics` - `total`	Integer	Number of field goals made
`field_goals_pct`	`statistics` - `total`	Decimal	Field goal percentage e.g. `56.5`
`field_goals_at_midrange_att`	`team` - `statistics`	Integer	Number of mid-range field goal attempts
`field_goals_at_midrange_made`	`team` - `statistics`	Integer	Number of mid-range field goals made
`field_goals_at_midrange_pct`	`team` - `statistics`	Decimal	Mid-range field goal percentage e.g. `56.5`
`field_goals_at_rim_att`	`team` - `statistics`	Integer	Number of field goal attempts at the rim
`field_goals_at_rim_made`	`team` - `statistics`	Integer	Number of field goals made at the rim
`field_goals_at_rim_pct`	`team` - `statistics`	Decimal	At the rim field goal percentage e.g. `56.5`
`flagrant_fouls`	`statistics` - `total`	Integer	Number of flagrant fouls
`foulouts`	`statistics` - `total`	Integer	Number of foul outs
`fouls_drawn`	`statistics` - `total`	Integer	Number of fouls drawn
`free_throws_att`	`statistics` - `total`	Integer	Number of free throw attempts
`free_throws_made`	`statistics` - `total`	Integer	Number of free throws made
`free_throws_pct`	`statistics` - `total`	Decimal	Free throw percentage e.g. `100.0`
`games_played`	`statistics` - `total`	Integer	Number of games played
`games_started`	`statistics` - `total`	Integer	Number of games started
`minus`	`statistics` - `total`	Integer	Number of team points against while a player is on the court
`minutes`	`statistics` - `total`	String	Number of minutes played e.g. `40:07`
`offensive_fouls`	`statistics` - `total`	Integer	Number of offensive fouls
`offensive_rebounds`	`statistics` - `total`	Integer	Number of offensive rebounds
`offensive_rebounds_pct`	`statistics` - `total`	Decimal	Offensive rebound percentage e.g. `20.0`
`personal_fouls`	`statistics` - `total`	Integer	Number of personal fouls
`plus`	`statistics` - `total`	Integer	Number of team points scored while a player is on the court
`points`	`statistics` - `total`	Integer	Number of points
`points_off_turnovers`	`statistics` - `total`	Integer	Points scored off turnovers
`rebounds`	`statistics` - `total`	Integer	Number of rebounds
`second_chance_att`	`statistics` - `total`	Integer	Number of second chance attempts
`second_chance_made`	`statistics` - `total`	Integer	Number of second chance baskets
`second_chance_pct`	`statistics` - `total`	Decimal	Second chance percentage e.g. `40.0`
`second_chance_pts`	`statistics` - `total`	Integer	Number of second chance points
`steals`	`statistics` - `total`	Integer	Number of steals
`technical_fouls`	`statistics` - `total`	Integer	Number of technical fouls
`three_points_att`	`statistics` - `total`	Integer	Number of 3-point attempts
`three_points_made`	`statistics` - `total`	Integer	Number of 3-point field goals made
`three_points_pct`	`statistics` - `total`	Decimal	3-point field goal percentage e.g. `42.9`
`total_turnovers`	`statistics` - `total`	Integer	Number of turnovers
`triple_doubles`	`statistics` - `total`	Integer	Number of triple-doubles
`true_shooting_att`	`statistics` - `total`	Integer	Number of true shooting attempts
`true_shooting_pct`	`statistics` - `total`	Decimal	True Shooting Percentage = (PTS / (2 × TSA)) × 100
`turnovers`	`statistics` - `total`	Integer	Number of turnovers
`two_points_att`	`statistics` - `total`	Integer	Number of 2-point field goal attempts
`two_points_made`	`statistics` - `total`	Integer	Number of 2-point field goals made
`two_points_pct`	`statistics` - `total`	Decimal	2-point field goal percentage e.g. `55.6`
`win_pct`	`team` - `statistics`	Decimal	Team win percentage
`wins`	`team` - `statistics`	Integer	Number of wins

Player Statistics (Season) - Averages

Attribute	Parent Element	Type	Description
`assists`	`statistics` - `average`	Decimal	Assists per game
`blocked_att`	`statistics` - `average`	Decimal	Blocked attempts per game
`blocks`	`statistics` - `average`	Integer	Shots blocked per game
`def_rebounds`	`statistics` - `average`	Decimal	Defensive rebounds per game
`efficiency`	`statistics` - `average`	Decimal	Player Efficiency Rating per game
`fast_break_att`	`statistics` - `average`	Decimal	Fast break attempts per game
`fast_break_made`	`statistics` - `average`	Decimal	Fast break baskets per game
`fast_break_pct`	`statistics` - `average`	Decimal	Fast break percentage per game e.g. `82.0`
`fast_break_pts`	`statistics` - `average`	Decimal	Fast break points per game
`field_goals_att`	`statistics` - `average`	Decimal	Field goal attempts per game
`field_goals_made`	`statistics` - `average`	Decimal	Field goals made per game
`flagrant_fouls`	`statistics` - `average`	Decimal	Flagrant fouls per game
`fouls_drawn`	`statistics` - `average`	Decimal	Fouls drawn per game
`free_throws_att`	`statistics` - `average`	Decimal	Free throw attempts per game
`free_throws_made`	`statistics` - `average`	Decimal	Free throws made per game
`minutes`	`statistics` - `average`	Decimal	Minutes played per game
`offensive_fouls`	`statistics` - `average`	Decimal	Offensive fouls per game
`off_rebounds`	`statistics` - `average`	Decimal	Offensive rebounds per game
`personal_fouls`	`statistics` - `average`	Decimal	Personal fouls per game
`points`	`statistics` - `average`	Decimal	Points per game
`points_off_turnovers`	`statistics` - `average`	Decimal	Points off turnovers per game
`rebounds`	`statistics` - `average`	Decimal	Rebounds per game
`second_chance_att`	`statistics` - `average`	Decimal	Second chance attempts per game
`second_chance_made`	`statistics` - `average`	Decimal	Second chance baskets per game
`second_chance_pts`	`statistics` - `average`	Decimal	Second chance points per game
`steals`	`statistics` - `average`	Decimal	Steals per game
`three_points_att`	`statistics` - `average`	Decimal	3-point attempts per game
`three_points_made`	`statistics` - `average`	Decimal	3-point field goals made per game
`total_turnovers`	`statistics` - `average`	Decimal	Turnovers per game
`turnovers`	`statistics` - `average`	Decimal	Turnovers per game
`two_points_att`	`statistics` - `average`	Decimal	2-point field goal attempts per game
`two_points_made`	`statistics` - `average`	Decimal	2-point field goals made per game

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `DEl` (Delaware)
`id`	`team`	GUID	Unique ID of a team ex. `67a79348-041a-45f6-bb12-722d38dc8dbf`
`market`	`team`	String	Market name of a team ex. `Delaware`
`name`	`team`	String	Team name ex. `Blue Coats`