get
https://api.sportradar.com/nba//v8//teams//profile.
NBA Team Profile provides top-level team information and a full roster of active players.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 4 hours
Data Updates: Updates in realtime as changes are made to rosters or player profiles
Managing RostersLearn how to use Team Profile to retrieve top-level team info and an active roster of players in our Rosters and Player Statuses integration scenario.
Data Points
Draft Info
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
pick | player - draft | Integer | Draft pick number of a player |
round | player - draft | Integer | Draft pick round of a player |
team_id | player - draft | Integer | Unique ID of a draft team ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c |
year | player - draft | Integer | Draft year of a player |
League
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | hierarchy - league | String | Alias of a league ex. NBA |
id | hierarchy - league | GUID | Unique ID of a league ex. 4353138d-4c22-4396-95d8-5f587d2df25c |
name | hierarchy - league | String | Name of a league ex. NBA |
alias | hierarchy - conference | String | Alias of a conference ex. EASTERN |
id | hierarchy - conference | GUID | Unique ID of a conference ex. 3960cfac-7361-4b30-bc25-8d393de6f62f |
name | hierarchy - conference | String | Name of a conference ex. EASTERN CONFERENCE |
alias | hierarchy - division | String | Alias of a division ex. SOUTHEAST |
id | hierarchy - division | GUID | Unique ID of a division ex. 54dc7348-c1d2-40d8-88b3-c4c0138e085d |
name | hierarchy - division | String | Name of a division ex. Southeast |
Player
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr_name | player | String | Abbreviated name of a player ex. S.Curry |
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 |
experience | player | String | Number of years played in the NBA |
first_name | player | String | First name of a player ex. Stephen |
full_name | player | String | Full name of a player ex. Stephen Curry |
height | player | unsignedByte | Height in inches |
high_school | player | String | High school attended ex. Whitehouse (TX) |
id | player | GUID | Unique player ID ex. 8ec91366-faea-4196-bbfd-b8fab7434795 |
jersey_number | player | Integer | Number of a player's jersey |
last_name | player | String | Last name of a player ex. Curry |
name_suffix | player | String | Suffix of a player ex. Jr. |
position | player | String | Position of a playerNA, C, C-F, F, F-C, F-G, G, G-F |
primary_position | player | String | Primary position of a playerNA, C, PF, PG, SF, SG |
reference | player | String | League reference ID of a player ex. 201939 |
rookie_year | player | unsignedShort | Rookie year in the NBA |
sr_id | player | GUID | Unique Sportradar ID of a player ex. sr:player:608110 |
salary | player | Integer | Current annual salary of a player ex. 2079935 |
status | player | String | Status of a playerACT (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) |
updated | player | dateTime | Timestamp of a change to a player profile ex. 2025-10-21T23:30:00+00:00 |
weight | player | unsignedShort | Weight in lbs. |
Player Reference
Use the
referencefield 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) |
Injuries
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
comment | player - injuries - injury | String | Text description of an injury ex. The Warriors announced that DiVincenzo will be re-evaluated this weekend. |
desc | injury | String | Brief description of an injury ex. Illness or Knee |
id | injury | GUID | Unique ID of an injury ex. 005ce145-9a3f-46f3-8884-3a84b6226941 |
start_date | injury | Date | Date an injury transaction goes into effect ex. 2022-10-30 |
status | injury | String | Status of an injuryUnknown, Day To Day, Out, Out for Season, Out Indefinitely |
update_date | transaction | Date | Date of an injury update ex. 2022-11-01 |
Team
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | team | String | Abbreviation of a team ex. SAC (Sacramento) |
championship_seasons | team | String | Years of championship seasons ex. 1991, 1992, 1993, 1996, 1997, 1998 |
championships_won | team | Integer | Number of championships won |
conference_titles | team | Integer | Number of conference titles |
division_titles | team | Integer | Number of division titles |
gleague_affiliate | team | String | A team's G League (NBA Development League) affiliate ex. Iowa Wolves |
founded | team | Integer | Year team was founded ex. 1946 |
general_manager | team | String | Team general manager ex. Monte McNair |
id | team | GUID | Unique ID of a team ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | team | String | Market name of a team ex. Sacramento |
mascot | team | String | Team mascot ex. Slamson the Lion |
name | team | String | Team name ex. Kings |
nicknames | team | String | Team nicknames ex. Wolves, T-Wolves |
owner | team | String | Team owner ex. Vivek Ranadivé |
playoff_appearances | team | Integer | Number of playoff appearances |
president | team | String | Team president ex. John Rinehart |
retired_numbers | team | String | Team retired jersey numbers ex. 1, 2, 4, 6, 11, 12, 14, 16, 21, 27, 44 |
reference | team | String | League reference ID of a team ex. 201939 |
sponsor | team | String | Team sponsor ex. Dialpad |
hex_color | team_color | String | Team color HEX value ex. #ffc62f |
type | team_color | String | Type of team colorprimary, secondary |
red | team_color - rgb-color | Integer | Team RGB color code - Red ex. 255 |
green | team_color - rgb-color | Integer | Team RGB color code - Green ex. 198 |
blue | team_color - rgb-color | Integer | Team RGB color code - Blue ex. 47 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3415 |
Coach
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
experience | coach | String | Number of years coached in the NBA |
first_name | coach | String | First name of a coach ex. Steve |
full_name | coach | String | Full name of a coach ex. Steve Kerr |
id | coach | GUID | Unique ID of a coach ex. 04bb3fde-d798-44a1-a4c1-2c98c9bbf04b |
last_name | coach | String | Last name of a coach ex. Kerr |
position | coach | String | Position of a coach ex. Head Coach or Assistant Coach |
reference | coach | String | League reference ID of a coach ex. 204005 |
Venue
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 500 David J. Stern Walkway |
capacity | venue | Integer | Capacity of a venue ex. 17608 |
city | venue | String | City of a venue ex. Sacramento |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. 2e687b9a-c7a7-487c-85b4-43479abc8458 |
lat | venue - location | Decimal | Latitude of a venue ex. 29.684735 |
lng | venue - location | Decimal | Longitude of a venue ex. -95.410725 |
name | venue | String | Name of a venue ex. Golden 1 Center |
sr_id | venue | GUID | Unique Sportradar ID of a venue ex. sr:venue:6942 |
state | venue | String | State or province of a venue ex. CA |
zip | venue | String | ZIP code of a venue ex. 95814 |