Skip to contents

One match's player box score by period (Rosetta-computed from the event log), one row per player and period.

Endpoint: GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all

Usage

nbl_rosetta_match_player_period_box(match_id)

Arguments

match_id

(character required): DataCore fixture id of the match (match_id of nbl_rosetta_matches), a UUID, e.g. b217a699-4bef-11f0-bc08-933162362355.

Value

A wehoop_data tibble (one row per player and period):

col_nametypedescription
match_idcharacterDataCore fixture id of the match (UUID v1): the {match_id} route key and fixtureId in play-by-play. Join on it.
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.
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_first_namecharacterThe player's given name, e.g. Elijah.
player_last_namecharacterThe player's family name, e.g. Pepper.
player_jersey_numbercharacterJersey number, a STRING.
player_playing_positioncharacterPlaying position code (G, F, C, PG, SF, FC, ...); null when not recorded.
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.
periodintegerPeriod as a STRING: 0 = game or season total, 1-4 = quarters, 11/12/13 = first/second/third overtime (inferred: fewer teams have each)
period_typecharacterPeriod type: regular (overtime unobserved)
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.
assistsintegerAssists in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
blocksintegerBlocks in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
defensive_reboundsintegerDefensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_attemptedintegerField goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_madeintegerField goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
field_goals_percentagedoubleField goals made / attempted, a 0-1 FRACTION.
foulsintegerFouls committed (personal + technical + others) in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_attemptedintegerFree throws attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_madeintegerFree throws made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
free_throws_percentagedoubleFree throws made / attempted, a 0-1 FRACTION.
minutesdoubleMinutes played: "MM:SS" string in player_match_statistics, decimal minutes in calculated_player_statistics, player-minutes (integer, 5 x period length) in team rows; "00:00" or 0 where not recorded.
offensive_reboundsintegerOffensive rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
personal_foulsintegerPersonal fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
pointsintegerPoints in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
reboundsintegerTotal rebounds in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
stealsintegerSteals in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
technical_foulsintegerTechnical fouls in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_attemptedintegerThree-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_madeintegerThree-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
three_points_percentagedoubleThree-point field goals made / attempted, a 0-1 FRACTION.
turnoversintegerTurnovers in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_attemptedintegerTwo-point field goals attempted in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_madeintegerTwo-point field goals made in the match, or in the period on period rows; 0 where the era did not record it (results-only seasons before pbp)
two_points_percentagedoubleTwo-point field goals made / attempted, a 0-1 FRACTION.
jersey_numbercharacterJersey number, a STRING.

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_match_player_period_box(match_id = "b217a699-4bef-11f0-bc08-933162362355")