Skip to main content

NBA G League — G League Stats API (stats.nba.com, LeagueID=20) — Common

nbagl_stats_commonallplayers​

Common all players.

Endpoint URL: GET https://stats.nba.com/stats/commonallplayers

Valid URL: https://stats.nba.com/stats/commonallplayers?IsOnlyCurrentSeason=0&LeagueID=20&Season=2024-25

API ParameterPythonPatternRequiredNullableDescription
IsOnlyCurrentSeasonis_only_current_seasonY
LeagueIDleague_idY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
person_idInt64
display_last_comma_firstStringPlayer name formatted as "Last, First".
display_first_lastStringPlayer name formatted as "First Last".
rosterstatusInt64Roster status flag (1 = currently on a roster, 0 = not).
from_yearString
to_yearString
playercodeStringURL-style player code slug used by the league's legacy stats pages.
player_slugString
team_idInt64
team_cityString
team_nameString
team_abbreviationString
team_codeStringLowercase slug of the player's team used in stats.nba.com URLs (e.g. 'lakers').
team_slugString
is_nba_assignedInt64Flag indicating whether the player is currently on an NBA roster assignment (two-way and G League assignment tracking).
nba_assigned_team_idInt64Team identifier of the NBA team the player is assigned to, when on assignment.
games_played_flagStringY/N flag for whether the player has appeared in a league game.
otherleague_experience_chStringCode for the player's experience in another league (e.g. G League), as reported by the stats API.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_commonallplayers(league_id='20', season='2024-25')

nbagl_stats_commonplayerinfo​

Common player info.

Endpoint URL: GET https://stats.nba.com/stats/commonplayerinfo

Valid URL: https://stats.nba.com/stats/commonplayerinfo?LeagueID=20&PlayerID=1642443

API ParameterPythonPatternRequiredNullableDescription
LeagueIDleague_idY
PlayerIDplayer_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (CommonPlayerInfo, PlayerHeadlineStats, AvailableSeasons) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

CommonPlayerInfo

col_nametypedescription
person_idInt64
first_nameString
last_nameString
display_first_lastStringNBA or WNBA Stats value for display first last in the commonplayerinfo result set.
display_last_comma_firstStringNBA or WNBA Stats value for display last comma first in the commonplayerinfo result set.
display_fi_lastStringNBA or WNBA Stats value for display fi last in the commonplayerinfo result set.
player_slugString
birthdateStringPlayer's date of birth as an ISO timestamp string (e.g. '1984-12-30T00:00:00').
schoolString
countryString
last_affiliationStringNBA or WNBA Stats value for last affiliation in the commonplayerinfo result set.
heightString
weightString
season_expInt64NBA or WNBA Stats value for season exp in the commonplayerinfo result set.
jerseyString
positionString
rosterstatusStringNBA or WNBA Stats value for rosterstatus in the commonplayerinfo result set.
games_played_current_season_flagStringFlag indicating games played current season flag for the requested NBA or WNBA Stats context.
team_idInt64
team_nameString
team_abbreviationString
team_codeStringLowercase slug of the player's current team used in stats.nba.com URLs (e.g. 'lakers').
team_cityString
playercodeStringNBA or WNBA Stats value for playercode in the commonplayerinfo result set.
from_yearInt64
to_yearInt64
dleague_flagStringFlag indicating dleague flag for the requested NBA or WNBA Stats context.
nba_flagStringFlag indicating NBA flag for the requested NBA or WNBA Stats context.
games_played_flagStringFlag indicating games played flag for the requested NBA or WNBA Stats context.
draft_yearString
draft_roundString
draft_numberStringOverall pick the player was selected with, as a string; 'Undrafted' when never drafted.
greatest_75_flagStringFlag indicating greatest 75 flag for the requested NBA or WNBA Stats context.

PlayerHeadlineStats

col_nametypedescription
player_idInt64
player_nameString
time_frameString
ptsFloat64
astFloat64
rebFloat64
pieInt64

AvailableSeasons

col_nametypedescription
season_idString

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_commonplayerinfo(league_id='20')

nbagl_stats_commonplayoffseries​

Common playoff series.

Endpoint URL: GET https://stats.nba.com/stats/commonplayoffseries

Valid URL: https://stats.nba.com/stats/commonplayoffseries?LeagueID=20&Season=2024-25&SeriesID=

API ParameterPythonPatternRequiredNullableDescription
LeagueIDleague_idY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeriesIDseries_id_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
game_idString
home_team_idInt64
visitor_team_idInt64
series_idStringPlayoff series id, the game id stem without the game sequence digit (e.g. '004230010' for the 2023-24 playoffs' first series).
game_numInt64NBA or WNBA Stats value for game number in the commonplayoffseries result set.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_commonplayoffseries(league_id='20', season='2024-25')

nbagl_stats_commonteamroster​

Common team roster.

Endpoint URL: GET https://stats.nba.com/stats/commonteamroster

Valid URL: https://stats.nba.com/stats/commonteamroster?LeagueID=20&Season=2024-25&TeamID=1612709914

API ParameterPythonPatternRequiredNullableDescription
LeagueIDleague_idY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
TeamIDteam_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (CommonTeamRoster, Coaches) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

CommonTeamRoster

col_nametypedescription
team_idInt64
seasonString
league_idStringLeague identifier from the stats API ("00" = NBA, "10" = WNBA, "20" = G League).
playerString
nicknameString
player_slugString
numStringJersey number as printed on the roster (string; may be blank or carry a suffix).
positionString
heightString
weightString
birth_dateString
ageFloat64
expString
schoolString
player_idInt64
how_acquiredStringHow the team acquired the player (e.g. draft, trade, free agency).

Coaches

col_nametypedescription
coach_idInt64
team_idInt64
seasonString
first_nameString
last_nameString
coach_nameString
is_assistantInt64
coach_typeString
sort_sequenceInt64

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_commonteamroster(league_id='20', season='2024-25')

nbagl_stats_commonteamyears​

Common team years.

Endpoint URL: GET https://stats.nba.com/stats/commonteamyears

Valid URL: https://stats.nba.com/stats/commonteamyears?LeagueID=20

API ParameterPythonPatternRequiredNullableDescription
LeagueIDleague_idY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
league_idString
team_idInt64
min_yearString
max_yearString
abbreviationString

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_commonteamyears(league_id='20')