⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Stats update around 5 minutes after a game moves to closed

Data Points

Draft Info

Attribute	Parent Element	Type	Description
`pick`	`draft`	Integer	Draft pick number of a player
`round`	`draft`	Integer	Draft pick round of a player
`team_id`	`draft`	Integer	Unique ID of a draft team ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c`
`year`	`draft`	Integer	Draft year of a player

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NBA`
`id`	`league`	GUID	Unique ID of a league ex. `4353138d-4c22-4396-95d8-5f587d2df25c`
`name`	`league`	String	Name of a league ex. `NBA`
`id`	`season`	GUID	Unique season ID ex. `583eca2f-fb46-11e1-82cb-f4ce4684ea4c`
`type`	`season`	String	Type of the season `PRE` (Preseason), `REG` (Regular Season), `IST` (In-Season Tournament), `PIT` (Play-In Tournament), `PST` (Postseason)
`year`	`season`	Integer	Year of the season

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. `1626157`
`rookie_year`	`player`	unsignedShort	Rookie year in the NBA
`salary`	`player`	Integer	Current annual salary of a player ex. `2079935`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:608110`
`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. `2022-09-30T22:55:57Z`
`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)

Player Statistics (Season) - Totals

Attribute	Parent Element	Type	Description
`assists`	`statistics` - `total`	Integer	Number of assists
`assists_turnover_ratio`	`statistics` - `total`	Decimal	Assist to turnover ratio
`blocked_att`	`statistics` - `total`	Integer	Number of blocked attempts
`blocks`	`statistics` - `total`	Integer	Number of shots blocked
`coach_ejections`	`statistics` - `total`	Integer	Number of coach ejections
`coach_tech_fouls`	`statistics` - `total`	Integer	Number of coach technical fouls
`defensive_rebounds`	`statistics` - `total`	Integer	Number of defensive rebounds
`double_doubles`	`statistics` - `total`	Integer	Number of double-doubles
`effective_fg_pct`	`statistics` - `total`	Decimal	Effective Field Goal Percentage (FG + 0.5 3P) / FGA*
`efficiency`	`statistics` - `total`	Decimal	Player Efficiency Rating
`ejections`	`statistics` - `total`	Integer	Number of ejections
`fast_break_att`	`statistics` - `total`	Integer	Number of fast break attempts
`fast_break_made`	`statistics` - `total`	Integer	Number of fast break baskets
`fast_break_pct`	`statistics` - `total`	Decimal	Fast break percentage ex. `100.0`
`fast_break_pts`	`statistics` - `total`	Integer	Number of fast break points
`field_goals_att`	`statistics` - `total`	Integer	Number of field goal attempts
`field_goals_made`	`statistics` - `total`	Integer	Number of field goals made
`field_goals_pct`	`statistics` - `total`	Decimal	Field goal percentage ex. `0.565`
`field_goals_at_midrange_att`	`statistics` - `total`	Integer	Number of mid-range field goal attempts
`field_goals_at_midrange_made`	`statistics` - `total`	Integer	Number of mid-range field goals made
`field_goals_at_midrange_pct`	`statistics` - `total`	Decimal	Mid-range field goal percentage ex. `0.565`
`field_goals_at_rim_att`	`statistics` - `total`	Integer	Number of field goal attempts at the rim
`field_goals_at_rim_made`	`statistics` - `total`	Integer	Number of field goals made at the rim
`field_goals_at_rim_pct`	`statistics` - `total`	Decimal	At the rim field goal percentage ex. `0.565`
`flagrant_fouls`	`statistics` - `total`	Integer	Number of flagrant fouls
`foulouts`	`statistics` - `total`	Integer	Number of foul outs
`fouls_drawn`	`statistics` - `total`	Integer	Number of fouls drawn
`free_throws_att`	`statistics` - `total`	Integer	Number of free throw attempts
`free_throws_made`	`statistics` - `total`	Integer	Number of free throws made
`free_throws_pct`	`statistics` - `total`	Decimal	Free throw percentage ex. `100.0`
`games_played`	`statistics` - `total`	Integer	Number of games played
`games_started`	`statistics` - `total`	Integer	Number of games started
`minus`	`statistics` - `total`	Integer	Number of team points against while a player is on the court
`minutes`	`statistics` - `total`	String	Number of minutes played ex. `40:07`
`offensive_fouls`	`statistics` - `total`	Integer	Number of offensive fouls
`offensive_rebounds`	`statistics` - `total`	Integer	Number of offensive rebounds
`offensive_rebounds_pct`	`statistics` - `total`	Decimal	Offensive rebound percentage ex. `20.0`
`personal_fouls`	`statistics` - `total`	Integer	Number of personal fouls
`plus`	`statistics` - `total`	Integer	Number of team points scored while a player is on the court
`points`	`statistics` - `total`	Integer	Number of points
`points_in_paint`	`statistics` - `total`	Integer	Number of points in the paint
`points_in_paint_att`	`statistics` - `total`	Integer	Number of points in the paint attempts
`points_in_paint_made`	`statistics` - `total`	Integer	Number of points in the paint baskets
`points_in_paint_pct`	`statistics` - `total`	Decimal	Points in the paint percentage ex. `28.6`
`points_off_turnovers`	`statistics` - `total`	Integer	Number of points off turnovers
`rebounds`	`statistics` - `total`	Integer	Number of rebounds
`second_chance_att`	`statistics` - `total`	Integer	Number of second chance attempts
`second_chance_made`	`statistics` - `total`	Integer	Number of second chance baskets
`second_chance_pct`	`statistics` - `total`	Decimal	Second chance percentage ex. `20.0`
`second_chance_pts`	`statistics` - `total`	Integer	Number of second chance points
`steals`	`statistics` - `total`	Integer	Number of steals
`tech_fouls`	`statistics` - `total`	Integer	Number of total unsportsmanlike technical fouls
`tech_fouls_non _unsportsmanlike`	`statistics` - `total`	Integer	Number of non-unsportsmanlike technical fouls
`three_points_att`	`statistics` - `total`	Integer	Number of 3-point attempts
`three_points_made`	`statistics` - `total`	Integer	Number of 3-point baskets
`three_points_pct`	`statistics` - `total`	Decimal	3-point percentage ex. `100.0`
`triple_double`	`statistics` - `total`	Integer	Number of triple-doubles
`true_shooting_att`	`statistics` - `total`	Decimal	Number of attempts used to determine true shooting percentage
`true_shooting_pct`	`statistics` - `total`	Decimal	True Shooting Percentage 100 * sPoints / (2 * sTrueShootingAttempts )
`turnovers`	`statistics` - `total`	Integer	Number of turnovers
`two_points_att`	`statistics` - `total`	Integer	Number of 2-point attempts
`two_points_made`	`statistics` - `total`	Integer	Number of 2-point baskets
`two_points_pct`	`statistics` - `total`	Decimal	2-point percentage ex. `100.0`
`usage_pct`	`statistics` - `total`	Decimal	Usage Percentage ex. `27.61`

Player Statistics (Season) - Averages

Attribute	Parent Element	Type	Description
`assists`	`statistics` - `average`	Decimal	Assists per game
`blocked_att`	`statistics` - `average`	Decimal	Blocked attempts per game
`blocks`	`statistics` - `average`	Integer	Shots blocked per game
`def_rebounds`	`statistics` - `average`	Decimal	Defensive rebounds per game
`efficiency`	`statistics` - `average`	Decimal	Player Efficiency Rating per game
`fast_break_att`	`statistics` - `average`	Decimal	Fast break attempts per game
`fast_break_made`	`statistics` - `average`	Decimal	Fast break baskets per game
`fast_break_pct`	`statistics` - `average`	Decimal	Fast break percentage per game ex. `82.0`
`fast_break_pts`	`statistics` - `average`	Decimal	Fast break points per game
`field_goals_att`	`statistics` - `average`	Decimal	Field goal attempts per game
`field_goals_made`	`statistics` - `average`	Decimal	Field goals made per game
`flagrant_fouls`	`statistics` - `average`	Decimal	Flagrant fouls per game
`fouls_drawn`	`statistics` - `average`	Decimal	Fouls drawn per game
`free_throws_att`	`statistics` - `average`	Decimal	Free throw attempts per game
`free_throws_made`	`statistics` - `average`	Decimal	Free throws made per game
`minutes`	`statistics` - `average`	Decimal	Minutes played per game
`offensive_fouls`	`statistics` - `average`	Decimal	Offensive fouls per game
`off_rebounds`	`statistics` - `average`	Decimal	Offensive rebounds per game
`personal_fouls`	`statistics` - `average`	Decimal	Personal fouls per game
`points`	`statistics` - `average`	Decimal	Points per game
`points_in_paint`	`statistics` - `average`	Decimal	Points in the paint per game
`points_in_paint_att`	`statistics` - `average`	Decimal	Points in the paint attempts per game
`points_in_paint_made`	`statistics` - `average`	Decimal	Points in the paint baskets per game
`points_off_turnovers`	`statistics` - `average`	Decimal	Points off turnovers per game
`rebounds`	`statistics` - `average`	Decimal	Rebounds per game
`second_chance_att`	`statistics` - `average`	Decimal	Second chance attempts per game
`second_chance_made`	`statistics` - `average`	Decimal	Second chance baskets per game
`second_chance_pts`	`statistics` - `average`	Decimal	Second chance points per game
`steals`	`statistics` - `average`	Decimal	Steals per game
`three_points_att`	`statistics` - `average`	Decimal	3-point attempts per game
`three_points_made`	`statistics` - `average`	Decimal	3-point baskets per game
`true_shooting_att`	`statistics` - `average`	Decimal	Number of attempts per game used to determine true shooting percentage
`turnovers`	`statistics` - `average`	Decimal	Turnovers per game
`two_points_att`	`statistics` - `average`	Decimal	2-point attempts per game
`two_points_made`	`statistics` - `average`	Decimal	2-point baskets per game

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `SAC` (Sacramento)
`id`	`team`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`team`	String	Market name of a team ex. `Sacramento`
`name`	`team`	String	Team name ex. `Kings`
`reference`	`team`	String	League reference ID of a team ex. `1610612750`
`sr_id`	`team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3415`

200200