Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Player Profile

NCAAMB 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: 30 minutes

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

📘

Accessing Player Stats

Learn how to use Player Profile to access biographical information and career-spanning seasonal statistics for each player in our Seasonal Statistics (Player & Team) integration scenario.


Data Points

League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. NCAAM
idleagueGUIDUnique ID of a league

ex. cd4268ee-07aa-4c4d-a435-ec44ad2c76cb
nameleagueStringName of a league

ex. NCAA MEN
idseasonGUIDUnique ID of a season

ex. 415ae0cb-38dd-4ace-8f22-fb6015b39006
typeseasonStringType of a season

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

ex. N.Cummings
birth_placeplayerStringBirthplace of a player

ex. Midland, PA, USA
experienceplayerStringYear in school

FR(Freshman), SO(Sophomore), JR(Junior), SR(Senior), GR(Graduate Student)
first_nameplayerStringFirst name of a player

ex. Nelly
full_nameplayerStringFull name of a player

ex. Nelly Cummings
heightplayerunsignedByteHeight in inches
idplayerGUIDUnique player ID

ex. 82643a21-c4ec-4725-b729-f4c65727c93d
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player

ex. Cummings
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), NWT (Not with Team), SUS(Suspended), DUP (Duplicate player profile), TP (Transfer Portal)
updatedplayerdateTimeTimestamp of a change to a free agent status

ex. 2025-10-21T23:30:00+00:00
weightplayerunsignedShortWeight in lbs.
Player Reference

Use the reference field to link a player's NCAA API profile to their NBA or G League API profile, if applicable

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)
AttributeParent ElementTypeDescription
assistsstatistics - totalIntegerNumber of assists
assistsstatistics - averageDecimalAssists per game
assists_turnover_ratiostatistics - totalDecimalAssist to turnover ratio
blocked_attstatistics - totalIntegerNumber of blocked attempts
blocked_attstatistics - averageDecimalBlocked attempts per game
blocksstatistics - totalIntegerNumber of shots blocked
blocksstatistics - averageIntegerShots blocked per game
defensive_reboundsstatistics - totalIntegerNumber of defensive rebounds
def_reboundsstatistics - averageDecimalDefensive rebounds per game
efficiencystatistics - totalDecimalPlayer Efficiency Rating

(sPoints + sAssists + sBlocks+sSteals + sFoulsDrawn + sReboundsTotal) - (sTurnovers + sBlocksReceived + sFoulsPersonal + sFoulsTechnical + (sTwoPointersAttempted - sTwoPointersMade) + (sThreePointersAttempted - sThreePointersMade) + (sFreeThrowsAttempted - sFreeThrowsMade))
efficiencystatistics - averageDecimalPlayer Efficiency Rating per game
ejectionsstatistics - totalIntegerNumber of ejections
field_goals_attstatistics - totalIntegerNumber of field goal attempts
field_goals_attstatistics - averageDecimalField goal attempts per game
field_goals_madestatistics - totalIntegerNumber of field goals made
field_goals_madestatistics - averageDecimalField goals made per game
field_goals_pctstatistics - totalDecimalField goal percentage

ex. 0.565
field_goals_at_midrange_attstatistics - totalIntegerNumber of mid-range field goal attempts
field_goals_at_midrange_madestatistics - totalIntegerNumber of mid-range field goals made
field_goals_at_midrange_pctstatistics - totalDecimalMid-range field goal percentage

ex. 0.565
field_goals_at_rim_attstatistics - totalIntegerNumber of field goal attempts at the rim
field_goals_at_rim_madestatistics - totalIntegerNumber of field goals made at the rim
field_goals_at_rim_pctstatistics - totalDecimalAt the rim field goal percentage

ex. 0.565
flagrant_foulsstatistics - totalIntegerNumber of flagrant fouls
flagrant_foulsstatistics - averageDecimalFlagrant fouls per game
fouloutsstatistics - totalIntegerNumber of foul outs
free_throws_attstatistics - totalIntegerNumber of free throw attempts
free_throws_attstatistics - averageDecimalFree throw attempts per game
free_throws_madestatistics - totalIntegerNumber of free throws made
free_throws_madestatistics - averageDecimalFree throws made per game
free_throws_pctstatistics - totalDecimalFree throw percentage

ex. 100.0
games_playedstatistics - totalIntegerNumber of games played
games_startedstatistics - totalIntegerNumber of games started
minutesstatistics - totalStringNumber of minutes played

ex. 40:07
minutesstatistics - averageDecimalMinutes played per game
offensive_reboundsstatistics - totalIntegerNumber of offensive rebounds
off_reboundsstatistics - averageDecimalOffensive rebounds per game
personal_foulsstatistics - totalIntegerNumber of personal fouls
personal_foulsstatistics - averageDecimalPersonal fouls per game
pointsstatistics - totalIntegerNumber of points
pointsstatistics - averageDecimalPoints per game
reboundsstatistics - totalIntegerNumber of rebounds
reboundsstatistics - averageDecimalRebounds per game
stealsstatistics - totalIntegerNumber of steals
stealsstatistics - averageDecimalSteals per game
tech_foulsstatistics - totalIntegerNumber of technical fouls
three_points_attstatistics - totalIntegerNumber of 3-point attempts
three_points_attstatistics - averageDecimal3-point attempts per game
three_points_madestatistics - totalIntegerNumber of 3-point baskets
three_points_madestatistics - averageDecimal3-point baskets per game
three_points_pctstatistics - totalDecimal3-point percentage

ex. 100.0
true_shooting_attstatistics - totalDecimalNumber of attempts used to determine true shooting percentage

sFieldGoalsAttempted + (0.44 * sFreeThrowsAttempted)
true_shooting_attstatistics - averageDecimalNumber of attempts per game used to determine true shooting percentage
true_shooting_pctstatistics - totalDecimalTrue Shooting Percentage

100 _ sPoints / (2 _ sTrueShootingAttempts )
turnoversstatistics - totalIntegerNumber of turnovers
turnoversstatistics - averageDecimalTurnovers per game
two_points_attstatistics - totalIntegerNumber of 2-point attempts
two_points_attstatistics - averageDecimal2-point attempts per game
two_points_madestatistics - totalIntegerNumber of 2-point baskets
two_points_madestatistics - averageDecimal2-point baskets per game
two_points_pctstatistics - totalDecimal2-point percentage

ex. 100.0
usage_pctstatistics - totalDecimalUsage Percentage: an estimate of the percentage of team plays used by a player while they are on the floor

ex. 27.61
Team
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team

ex. PITT
idteamGUIDUnique ID of a team

ex. 24051034-96bb-4f78-a3a6-312f3258780f
marketteamStringSchool name of a team

ex. Pittsburgh
nameteamStringTeam name

ex. Panthers
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 7f2291a6-298b-44ce-9dde-21894f386fd3

Unique Id of a player

Example: 7f2291a6-298b-44ce-9dde-21894f386fd3

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