Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Player Profile

NBA G League Player Profile Provides player biographical information and seasonal statistics.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache:

  • 15 minutes for active players
  • 12 hours for retired players

Data Updates: Stats update around 5 minutes after a game moves to closed

Recommended Pull (Non-Live): As needed; the daily change log captures post-game changes

Recommended Pull (Live): 5 to 10 minutes after a game closes

📘

Accessing Player Stats

Learn how to use Player Profile to access biographical information and career-spanning seasonal statistics for each player in our Rosters and Player Statuses integration scenario.


Data Points

Browse this endpoint's available data points and their definitions below.

Draft Info
AttributeParent ElementTypeDescription
pickdraftIntegerDraft pick number of a player
rounddraftIntegerDraft pick round of a player
team_iddraftIntegerUnique ID of a draft team

ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c
yeardraftIntegerDraft year of a player
League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. NBDL
idleagueGUIDUnique ID of a league

ex. ac79301f-9b1a-4e72-a4cb-230d4418ae08
nameleagueStringName of a league

ex. NBA G League
idseasonGUIDUnique ID of a season

ex. 2a29bf58-7069-4ca4-8933-0347544e243d
typeseasonStringType of a season

REG (Regular Season)
yearseasonIntegerYear of a season
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. J.Jackson
birthdateplayerDatePlayer date of birth

ex. 1995-03-28
birth_placeplayerStringBirthplace of a player

ex. Houston, TX, USA
collegeplayerStringCollege attended

ex. North Carolina
experienceplayerIntegerNumber of years played in the NBA
first_nameplayerStringFirst name of a player

ex. Justin
full_nameplayerStringFull name of a player

ex. Justin Jackson
heightplayerIntegerHeight in inches
high_schoolplayerStringHigh school attended

ex. Homeschool Christian Youth (TX)
idplayerGUIDUnique player ID

ex. fd1b8de8-1ea6-446e-9a86-a89bc28ae510
jersey_numberplayerStringNumber of a player's jersey
last_nameplayerStringLast name of a player

ex. Jackson
positionplayerStringPosition of a player

NA, C, C-F, F, F-C, F-G, G, G-F
primary_positionplayerStringPrimary position of a player

NA, C, PF, PG, SF, SG
statusplayerStringStatus 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)
updatedplayerdateTimeTimestamp of a change to a player profile

ex. 2025-10-21T23:30:00+00:00
weightplayerIntegerWeight 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

AttributeParent ElementTypeDescription
id_typeplayer - referenceStringType 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)
scopeplayer - referenceStringName 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_idplayer - referenceGUIDUnique 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
AttributeParent ElementTypeDescription
assistsstatistics - totalIntegerNumber of assists
assists_turnover_ratiostatistics - totalDecimalAssist to turnover ratio
blocked_attstatistics - totalIntegerNumber of blocked attempts
blocksstatistics - totalIntegerNumber of shots blocked
coach_ejectionsstatistics - totalIntegerNumber of coach ejections
coach_tech_foulsstatistics - totalIntegerNumber of coach technical fouls
defensive_reboundsstatistics - totalIntegerNumber of defensive rebounds
double_doublesstatistics - totalIntegerNumber of double-doubles
effective_fg_pctstatistics - totalDecimalEffective Field Goal Percentage (FG + 0.5 × 3P) / FGA
efficiencystatistics - totalDecimalPlayer Efficiency Rating (sPoints + sAssists + sBlocks + sSteals + sFoulsDrawn + sReboundsTotal) - (sTurnovers + sBlocksReceived + sFoulsPersonal + sFoulsTechnical + (sTwoPointersAttempted - sTwoPointersMade) + (sThreePointersAttempted - sThreePointersMade) + (sFreeThrowsAttempted - sFreeThrowsMade))
ejectionsstatistics - totalIntegerNumber of ejections
fast_break_attstatistics - totalIntegerNumber of fast break attempts
fast_break_madestatistics - totalIntegerNumber of fast break baskets
fast_break_pctstatistics - totalDecimalFast break percentage e.g. 100.0
fast_break_ptsstatistics - totalIntegerNumber of fast break points
field_goals_attstatistics - totalIntegerNumber of field goal attempts
field_goals_madestatistics - totalIntegerNumber of field goals made
field_goals_pctstatistics - totalDecimalField goal percentage e.g. 0.565
field_goals_at_midrange_attteam - statisticsIntegerNumber of mid-range field goal attempts
field_goals_at_midrange_madeteam - statisticsIntegerNumber of mid-range field goals made
field_goals_at_midrange_pctteam - statisticsDecimalMid-range field goal percentage e.g. 0.565
field_goals_at_rim_attteam - statisticsIntegerNumber of field goal attempts at the rim
field_goals_at_rim_madeteam - statisticsIntegerNumber of field goals made at the rim
field_goals_at_rim_pctteam - statisticsDecimalAt the rim field goal percentage e.g. 0.565
flagrant_foulsstatistics - totalIntegerNumber of flagrant fouls
fouloutsstatistics - totalIntegerNumber of foul outs
fouls_drawnstatistics - totalIntegerNumber of fouls drawn
free_throws_attstatistics - totalIntegerNumber of free throw attempts
free_throws_madestatistics - totalIntegerNumber of free throws made
free_throws_pctstatistics - totalDecimalFree throw percentage e.g. 100.0
games_playedstatistics - totalIntegerNumber of games played
games_startedstatistics - totalIntegerNumber of games started
minusstatistics - totalIntegerNumber of team points against while a player is on the court
minutesstatistics - totalStringNumber of minutes played e.g. 40:07
offensive_foulsstatistics - totalIntegerNumber of offensive fouls
offensive_reboundsstatistics - totalIntegerNumber of offensive rebounds
offensive_rebounds_pctstatistics - totalDecimalOffensive rebound percentage e.g. 20.0
personal_foulsstatistics - totalIntegerNumber of personal fouls
plusstatistics - totalIntegerNumber of team points scored while a player is on the court
pointsstatistics - totalIntegerNumber of points
points_off_turnoversstatistics - totalIntegerPoints scored off turnovers
reboundsstatistics - totalIntegerNumber of rebounds
second_chance_attstatistics - totalIntegerNumber of second chance attempts
second_chance_madestatistics - totalIntegerNumber of second chance baskets
second_chance_pctstatistics - totalDecimalSecond chance percentage e.g. 40.0
second_chance_ptsstatistics - totalIntegerNumber of second chance points
stealsstatistics - totalIntegerNumber of steals
technical_foulsstatistics - totalIntegerNumber of technical fouls
three_points_attstatistics - totalIntegerNumber of 3-point attempts
three_points_madestatistics - totalIntegerNumber of 3-point field goals made
three_points_pctstatistics - totalDecimal3-point field goal percentage e.g. 42.9
total_turnoversstatistics - totalIntegerNumber of turnovers
triple_doublesstatistics - totalIntegerNumber of triple-doubles
true_shooting_attstatistics - totalDecimalNumber of true shooting attempts
true_shooting_pctstatistics - totalDecimalTrue Shooting Percentage = (PTS / (2 × TSA)) × 100
turnoversstatistics - totalIntegerNumber of turnovers
two_points_attstatistics - totalIntegerNumber of 2-point field goal attempts
two_points_madestatistics - totalIntegerNumber of 2-point field goals made
two_points_pctstatistics - totalDecimal2-point field goal percentage e.g. 55.6
win_pctteam - statisticsDecimalTeam win percentage
winsteam - statisticsIntegerNumber of wins
Player Statistics (Season) - Averages
AttributeParent ElementTypeDescription
assistsstatistics - averageDecimalAssists per game
blocked_attstatistics - averageDecimalBlocked attempts per game
blocksstatistics - averageIntegerShots blocked per game
def_reboundsstatistics - averageDecimalDefensive rebounds per game
efficiencystatistics - averageDecimalPlayer Efficiency Rating per game
fast_break_attstatistics - averageDecimalFast break attempts per game
fast_break_madestatistics - averageDecimalFast break baskets per game
fast_break_pctstatistics - averageDecimalFast break percentage per game e.g. 82.0
fast_break_ptsstatistics - averageDecimalFast break points per game
field_goals_attstatistics - averageDecimalField goal attempts per game
field_goals_madestatistics - averageDecimalField goals made per game
flagrant_foulsstatistics - averageDecimalFlagrant fouls per game
fouls_drawnstatistics - averageDecimalFouls drawn per game
free_throws_attstatistics - averageDecimalFree throw attempts per game
free_throws_madestatistics - averageDecimalFree throws made per game
minutesstatistics - averageDecimalMinutes played per game
offensive_foulsstatistics - averageDecimalOffensive fouls per game
off_reboundsstatistics - averageDecimalOffensive rebounds per game
personal_foulsstatistics - averageDecimalPersonal fouls per game
pointsstatistics - averageDecimalPoints per game
points_off_turnoversstatistics - averageDecimalPoints off turnovers per game
reboundsstatistics - averageDecimalRebounds per game
second_chance_attstatistics - averageDecimalSecond chance attempts per game
second_chance_madestatistics - averageDecimalSecond chance baskets per game
second_chance_ptsstatistics - averageDecimalSecond chance points per game
stealsstatistics - averageDecimalSteals per game
three_points_attstatistics - averageDecimal3-point attempts per game
three_points_madestatistics - averageDecimal3-point field goals made per game
total_turnoversstatistics - averageDecimalTurnovers per game
turnoversstatistics - averageDecimalTurnovers per game
two_points_attstatistics - averageDecimal2-point field goal attempts per game
two_points_madestatistics - averageDecimal2-point field goals made per game
Team
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team

ex. DEL (Delaware)
idteamGUIDUnique ID of a team

ex. 67a79348-041a-45f6-bb12-722d38dc8dbf
marketteamStringMarket name of a team

ex. Delaware
nameteamStringTeam name

ex. Blue Coats
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

en (English)

Allowed:
string
required
Defaults to f428e27d-2e62-46a5-bde2-1b6f7f378cee

Unique Id of a player

Example: f428e27d-2e62-46a5-bde2-1b6f7f378cee

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