⏱️
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

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 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`
`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 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)
`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 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)

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 injury `Unknown`, `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 color `primary`, `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`