Skip to contents

A player's game log for a season: the box-score line of each game (period 0 = whole game) and the game.

Endpoint: GET https://prod.rosetta.nbl.com.au/get/{org}/player_boxscores/for/{player_id}/in/season/{season}/regular

Usage

nbl_rosetta_player_game_log(
  player_id,
  season,
  org = "wnbl",
  participated = NULL
)

Arguments

player_id

(character required): Player id: the DataCore person id (player_id of nbl_rosetta_players) or Rosetta's own id; either is accepted.

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

participated

(integer default NULL): 1 = only games the player played in (without it, games on the roster that he sat out too). Sent as filter[participated].

Value

A wehoop_data tibble (one row per game):

col_nametypedescription
orgcharacterOrganisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
periodintegerPeriod as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
playing_positioncharacterPlaying position code (G, F, C, PG, SF, FC, ...); null when not recorded.
pointsintegerPoints in the game.
reboundsintegerTotal rebounds in the game.
assistsintegerAssists in the game.
blocksintegerBlocks in the game.
stealsintegerSteals in the game.
turnoversintegerTurnovers in the game.
offensive_reboundsintegerOffensive rebounds in the game.
defensive_reboundsintegerDefensive rebounds in the game.
personal_foulsintegerPersonal fouls in the game.
three_points_attemptedintegerThree-point field goals attempted in the game.
three_points_madeintegerThree-point field goals made in the game.
three_points_percentagedoubleThree-point field goals made / attempted, a 0-1 FRACTION.
two_points_attemptedintegerTwo-point field goals attempted in the game.
two_points_madeintegerTwo-point field goals made in the game.
two_points_percentagedoubleTwo-point field goals made / attempted, a 0-1 FRACTION.
field_goals_attemptedintegerField goals attempted in the game.
field_goals_madeintegerField goals made in the game.
field_goals_percentagedoubleField goals made / attempted, a 0-1 FRACTION.
free_throws_attemptedintegerFree throws attempted in the game.
free_throws_madeintegerFree throws made in the game.
free_throws_percentagedoubleFree throws made / attempted, a 0-1 FRACTION.
minutesdoubleMinutes played, decimal minutes.
participatedlogicalPlayer took part in the game.
match_idcharacterDataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
rosetta_match_idcharacterRosetta's match RECORD id (UUID v4) as carried by box-score and play-by-play rows; no route accepts it. Join on match_id.
match_start_time_datetimecharacterTip-off, UTC; same value as start_time.
match_statuscharacterStatus of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial.
match_season_idcharacterDataCore id (UUID v1, Sportradar) of the match's season; stable across seasons and the id to join on across routes.
rosetta_match_season_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the match's season; routes that take this entity accept it as well as the DataCore id.
match_season_yearintegerSeason year as a STRING. NBL and WNBL from 1998-99: the START year ("2025" = 2025-26, sdv END = year + 1). NBL and WNBL 1979-1997 and every NBL1 season: the calendar year the season was played (END = year). Year 1998 holds two NBL and two WNBL seasons (calendar 1998 and 1998-99): tell them apart by start_date.
match_season_typecharacterSeason type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
rosetta_match_home_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the match's home team; routes that take this entity accept it as well as the DataCore id.
match_home_team_namecharacterDisplay name of the team.
match_home_team_codecharacterTeam code of the match's home team, e.g. PER or SYD.
rosetta_match_away_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the match's away team; routes that take this entity accept it as well as the DataCore id.
match_away_team_namecharacterDisplay name of the team.
match_away_team_codecharacterTeam code of the match's away team, e.g. PER or SYD.
player_idcharacterDataCore id (UUID v1, Sportradar) of the player; stable across seasons and the id to join on across routes.
rosetta_player_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the player; routes that take this entity accept it as well as the DataCore id.
player_jersey_numbercharacterJersey number, a STRING.
player_first_namecharacterThe player's given name, e.g. Elijah.
player_last_namecharacterThe player's family name, e.g. Pepper.
team_idcharacterDataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_namecharacterName of the team as Rosetta spells it, e.g. Perth Wildcats.
team_codecharacterTeam code, e.g. PER (the {team_code} path value)
sc_total_scoreintegerSuperCoach score including double-double / triple-double bonuses.
sc_total_score_without_dd_and_tdintegerSuperCoach score without those bonuses.
sc_breakdown_points_valueintegerThe stat's value for the game or season.
sc_breakdown_points_pointsintegerSuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_rebounds_valueintegerThe stat's value for the game or season.
sc_breakdown_rebounds_pointsintegerSuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_assists_valueintegerThe stat's value for the game or season.
sc_breakdown_assists_pointsintegerSuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_blocks_valueintegerThe stat's value for the game or season.
sc_breakdown_blocks_pointsintegerSuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_steals_valueintegerThe stat's value for the game or season.
sc_breakdown_steals_pointsintegerSuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_breakdown_turnovers_valueintegerThe stat's value for the game or season.
sc_breakdown_turnovers_pointsintegerSuperCoach points this stat earns (e.g. 3 per steal or block, -2 per turnover)
sc_double_figure_countintegerStats in double figures (for the double-double / triple-double bonus)
sc_season_totalintegerPlayer's SuperCoach total for the season so far.
season_end_yearintegersdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: <entity>id columns are DataCore ids (UUID v1; join on them), rosetta<entity>_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

 nbl_rosetta_player_game_log(
   org = "nbl", participated = 1, player_id = "7619d3ea-410d-11f0-9235-2902fc2f936f",
   season = 2026
 )