Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Team Profile

NBA Team Profile provides top-level team information and a full roster of active players.

⏱️

Update Frequency

TTL / Cache: 300 Seconds

Data Updates: Updates are made in realtime as changes are made to rosters or player profiles.



Data Points

Draft Info:
AttributeParent ElementTypeDescription
pickplayer - draftIntegerDraft pick number of a player
roundplayer - draftIntegerDraft pick round of a player
team_idplayer - draftIntegerUnique ID of a draft team
ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c
yearplayer - draftIntegerDraft year of a player
League:
AttributeParent ElementTypeDescription
aliashierarchy - leagueStringAlias of a league
ex. NBA
idhierarchy - leagueGUIDUnique ID of a league
ex. 4353138d-4c22-4396-95d8-5f587d2df25c
namehierarchy - leagueStringName of a league
ex. NBA
aliashierarchy - conferenceStringAlias of a conference
ex. EASTERN
idhierarchy - conferenceGUIDUnique ID of a conference
ex. 3960cfac-7361-4b30-bc25-8d393de6f62f
namehierarchy - conferenceStringName of a conference
ex. EASTERN CONFERENCE
aliashierarchy - divisionStringAlias of a division
ex. SOUTHEAST
idhierarchy - divisionGUIDUnique ID of a division
ex. 54dc7348-c1d2-40d8-88b3-c4c0138e085d
namehierarchy - divisionStringName of a division
ex. Southeast
Player:
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player
ex. S.Curry
birth_dateplayerDatePlayer date of birth
ex. 1995-09-17
birth_placeplayerStringBirthplace of a player
ex. Tyler, TX, USA
collegeplayerStringCollege attended
ex. Texas Tech
experienceplayerStringNumber of years played in the NBA
first_nameplayerStringFirst name of a player
ex. Stephen
full_nameplayerStringFull name of a player
ex. Stephen Curry
heightplayerunsignedByteHeight in inches
high_schoolplayerStringHigh school attended
ex. Whitehouse (TX)
idplayerGUIDUnique player ID
ex. 8ec91366-faea-4196-bbfd-b8fab7434795
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player
ex. Curry
name_suffixplayerStringSuffix of a player
ex. Jr.
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
referenceplayerStringLeague reference ID of a player
ex. 201939
rookie_yearplayerunsignedShortRookie year in the NBA
sr_idplayerGUIDUnique Sportradar ID of a player
ex. sr:player:608110
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), M-LEAGUE (Sent to minor league team), TEN-DAY (10-day Contract)
updatedplayerdateTimeTimestamp of a change to a free agent status
ex. 2024-02-14T05:00:00Z
weightplayerunsignedShortWeight in lbs.
Injuries:
AttributeParent ElementTypeDescription
commentplayer - injuries - injuryStringText description of an injury
ex. The Warriors announced that DiVincenzo will be re-evaluated this weekend.
descinjuryStringBrief description of an injury
ex. Illness or Knee
idinjuryGUIDUnique ID of an injury
ex. 005ce145-9a3f-46f3-8884-3a84b6226941
start_dateinjuryDateDate an injury transaction goes into effect
ex. 2022-10-30
statusinjuryStringStatus of an injury
Unknown, Day To Day, Out, Out for Season, Out Indefinitely
update_datetransactionDateDate of an injury update
ex. 2022-11-01
Team:
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team
ex. SAC (Sacramento)
championship_seasonsteamStringYears of championship seasons
ex. 1991, 1992, 1993, 1996, 1997, 1998
championships_wonteamIntegerNumber of championships won
conference_titlesteamIntegerNumber of conference titles
division_titlesteamIntegerNumber of division titles
gleague_affiliateteamStringA team's G League (NBA Development League) affiliate
ex. Iowa Wolves
foundedteamIntegerYear team was founded
ex. 1946
general_managerteamStringTeam general manager
ex. Monte McNair
idteamGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketteamStringMarket name of a team
ex. Sacramento
mascotteamStringTeam mascot
ex. Slamson the Lion
nameteamStringTeam name
ex. Kings
nicknamesteamStringTeam nicknames
ex. Wolves, T-Wolves
ownerteamStringTeam owner
ex. Vivek Ranadivé
playoff_appearancesteamIntegerNumber of playoff appearances
presidentteamStringTeam president
ex. John Rinehart
retired_numbersteamStringTeam retired jersey numbers
ex. 1, 2, 4, 6, 11, 12, 14, 16, 21, 27, 44
referenceteamStringLeague reference ID of a team
ex. 201939
sponsorteamStringTeam sponsor
ex. Dialpad
hex_colorteam_colorStringTeam color HEX value
ex. #ffc62f
typeteam_colorStringType of team color
primary, secondary
redteam_color - rgb-colorIntegerTeam RGB color code - Red
ex. 255
greenteam_color - rgb-colorIntegerTeam RGB color code - Green
ex. 198
blueteam_color - rgb-colorIntegerTeam RGB color code - Blue
ex. 47
sr_idteamGUIDUnique Sportradar ID of a team
ex. sr:team:3415
Coach:
AttributeParent ElementTypeDescription
experiencecoachStringNumber of years coached in the NBA
first_namecoachStringFirst name of a coach
ex. Steve
full_namecoachStringFull name of a coach
ex. Steve Kerr
idcoachGUIDUnique ID of a coach
ex. 04bb3fde-d798-44a1-a4c1-2c98c9bbf04b
last_namecoachStringLast name of a coach
ex. Kerr
positioncoachStringPosition of a coach
ex. Head Coach or Assistant Coach
referencecoachStringLeague reference ID of a coach
ex. 204005
Venue:
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 500 David J. Stern Walkway
capacityvenueStringCapacity of a venue
ex. 17608
cityvenueStringCity of a venue
ex. Sacramento
countryvenueStringCountry of a venue
ex. USA
idvenueGUIDUnique ID of a venue
ex. 2e687b9a-c7a7-487c-85b4-43479abc8458
latvenue - locationDecimalLatitude of a venue
ex. 29.684735
lngvenue - locationDecimalLongitude of a venue
ex. -95.410725
namevenueStringName of a venue
ex. Golden 1 Center
sr_idvenueGUIDUnique Sportradar ID of a venue
ex. sr:venue:6942
statevenueStringState or province of a venue
ex. CA
zipvenueIntegerZIP code of a venue
ex. 95814
Language
Authorization
Query
Click Try It! to start a request and see the response here!