Skip to main content

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

nbagl_stats_scheduleleaguev2​

Schedule league v2.

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

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

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.

Returns​

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

col_nametypedescription
arena_cityStringCity hosting the game's arena.
arena_nameStringName of the arena hosting the game.
arena_stateStringState or province of the game's arena (blank for international sites).
away_team_cityStringCity of the away team.
away_team_idInt64stats.nba.com / stats.wnba.com team id of the away team.
away_team_lossesInt64Away team's losses entering the game.
away_team_nameStringAway team nickname (e.g. Fever).
away_team_scoreInt64Away team's final score, 0 before the game is played.
away_team_seedInt64Away team's playoff seed, 0 outside the postseason.
away_team_slugStringURL slug of the away team.
away_team_timeStringScheduled tip-off in the away team's local time zone.
away_team_tricodeStringThree-letter abbreviation of the away team.
away_team_winsInt64Away team's wins entering the game.
branch_linkStringDeep link for the game, blank when not published.
dayStringThree-letter day of week of the game date.
game_codeStringProvider game code, YYYYMMDD/AWYHOM.
game_dateStringGame date as served by the schedule feed (MM/DD/YYYY HH:MM:SS).
game_date_estStringGame date at midnight Eastern, ISO-8601.
game_date_time_estStringScheduled tip-off in Eastern time, ISO-8601.
game_date_time_utcStringScheduled tip-off in UTC, ISO-8601. The timestamp to reduce to a calendar date.
game_date_utcStringGame date at midnight UTC, ISO-8601.
game_idStringUnique stats.nba.com / stats.wnba.com game id; its 3rd character encodes the season type.
game_labelStringHuman-readable round or event label (e.g. Preseason, Conf. Finals).
game_sequenceInt64Ordinal of the game within its date.
game_statusInt64Game status code: 1 scheduled, 2 in progress, 3 final.
game_status_textStringHuman-readable game status (e.g. Final, 7:00 pm ET).
game_sub_labelStringSecondary event label (e.g. NBA Abu Dhabi Game).
game_subtypeStringGame subtype tag (e.g. Global Games), blank for standard games.
game_time_estStringScheduled tip-off time of day, Eastern.
game_time_utcStringScheduled tip-off time of day, UTC.
home_team_cityStringCity of the home team.
home_team_idInt64stats.nba.com / stats.wnba.com team id of the home team.
home_team_lossesInt64Home team's losses entering the game.
home_team_nameStringHome team nickname (e.g. Liberty).
home_team_scoreInt64Home team's final score, 0 before the game is played.
home_team_seedInt64Home team's playoff seed, 0 outside the postseason.
home_team_slugStringURL slug of the home team.
home_team_timeStringScheduled tip-off in the home team's local time zone.
home_team_tricodeStringThree-letter abbreviation of the home team.
home_team_winsInt64Home team's wins entering the game.
if_necessaryStringWhether the game is a conditional series game that may not be played.
is_neutralBooleanWhether the game is played at a neutral site.
league_idStringLeague id of the schedule: '00' NBA, '10' WNBA, '20' G-League.
month_numInt64Calendar month number of the game date.
postponed_statusStringPostponement status; 'N' when the game is on as scheduled.
seasonStringSeason the schedule covers, as published by the feed ('2025-26' for the NBA, '2026' for the WNBA).
season_type_descriptionStringSeason type label derived from season_type_id: Pre-Season, Regular Season, All-Star, Playoffs, Play-In Game.
season_type_idStringSeason type digit, the 3rd character of game_id.
series_game_numberStringGame number within a playoff series, blank outside a series.
series_textStringSeries context line (e.g. series tied 1-1), blank when not applicable.
week_nameStringName of the schedule week, blank outside the regular season.
week_numberInt64Schedule week number, 0 outside the regular season.

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_scheduleleaguev2(league_id='20', season='2024-25')

nbagl_stats_scheduleleaguev2int​

Schedule league v2 int.

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

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

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.

Returns​

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

col_nametypedescription
arena_cityStringCity hosting the game's arena.
arena_nameStringName of the arena hosting the game.
arena_stateStringState or province of the game's arena (blank for international sites).
away_team_cityStringCity of the away team.
away_team_idInt64stats.nba.com / stats.wnba.com team id of the away team.
away_team_lossesInt64Away team's losses entering the game.
away_team_nameStringAway team nickname (e.g. Fever).
away_team_scoreInt64Away team's final score, 0 before the game is played.
away_team_seedInt64Away team's playoff seed, 0 outside the postseason.
away_team_slugStringURL slug of the away team.
away_team_timeStringScheduled tip-off in the away team's local time zone.
away_team_tricodeStringThree-letter abbreviation of the away team.
away_team_winsInt64Away team's wins entering the game.
branch_linkStringDeep link for the game, blank when not published.
dayStringThree-letter day of week of the game date.
game_codeStringProvider game code, YYYYMMDD/AWYHOM.
game_dateStringGame date as served by the schedule feed (MM/DD/YYYY HH:MM:SS).
game_date_estStringGame date at midnight Eastern, ISO-8601.
game_date_time_estStringScheduled tip-off in Eastern time, ISO-8601.
game_date_time_utcStringScheduled tip-off in UTC, ISO-8601. The timestamp to reduce to a calendar date.
game_date_utcStringGame date at midnight UTC, ISO-8601.
game_idStringUnique stats.nba.com / stats.wnba.com game id; its 3rd character encodes the season type.
game_labelStringHuman-readable round or event label (e.g. Preseason, Conf. Finals).
game_sequenceInt64Ordinal of the game within its date.
game_statusInt64Game status code: 1 scheduled, 2 in progress, 3 final.
game_status_textStringHuman-readable game status (e.g. Final, 7:00 pm ET).
game_sub_labelStringSecondary event label (e.g. NBA Abu Dhabi Game).
game_subtypeStringGame subtype tag (e.g. Global Games), blank for standard games.
game_time_estStringScheduled tip-off time of day, Eastern.
game_time_utcStringScheduled tip-off time of day, UTC.
home_team_cityStringCity of the home team.
home_team_idInt64stats.nba.com / stats.wnba.com team id of the home team.
home_team_lossesInt64Home team's losses entering the game.
home_team_nameStringHome team nickname (e.g. Liberty).
home_team_scoreInt64Home team's final score, 0 before the game is played.
home_team_seedInt64Home team's playoff seed, 0 outside the postseason.
home_team_slugStringURL slug of the home team.
home_team_timeStringScheduled tip-off in the home team's local time zone.
home_team_tricodeStringThree-letter abbreviation of the home team.
home_team_winsInt64Home team's wins entering the game.
if_necessaryBooleanWhether the game is a conditional series game that may not be played.
is_neutralBooleanWhether the game is played at a neutral site.
league_idStringLeague id of the schedule: '00' NBA, '10' WNBA, '20' G-League.
month_numInt64Calendar month number of the game date.
postponed_statusStringPostponement status; 'N' when the game is on as scheduled.
seasonStringSeason the schedule covers, as published by the feed ('2025-26' for the NBA, '2026' for the WNBA).
season_type_descriptionStringSeason type label derived from season_type_id: Pre-Season, Regular Season, All-Star, Playoffs, Play-In Game.
season_type_idStringSeason type digit, the 3rd character of game_id.
series_game_numberStringGame number within a playoff series, blank outside a series.
series_textStringSeries context line (e.g. series tied 1-1), blank when not applicable.
week_nameStringName of the schedule week, blank outside the regular season.
week_numberInt64Schedule week number, 0 outside the regular season.

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_scheduleleaguev2int(league_id='20', season='2024-25')