Skip to main content

NBL Australia (Rosetta) — NBL / WNBL / NBL1 Rosetta proxy (prod.rosetta.nbl.com.au, Australia) — Next

nbl_rosetta_next_match​

The organisation's next scheduled match (empty between seasons).

Endpoint URL: GET https://prod.rosetta.nbl.com.au/get/next/match/for/{org}/{season}

Valid URL: https://prod.rosetta.nbl.com.au/get/next/match/for/nbl/2027

API ParameterPythonPatternRequiredNullableDescription
orgorgYOrganisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences).
seasonseasonYSeason 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.

Returns​

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

col_nametypedescription
orgcharacterOrganisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_idcharacterDataCore fixture id (UUID v1); equal to id.
external_media_idcharacterMedia id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
date_updatedcharacterRecord last-edit time, ISO 8601 UTC.
start_timecharacterTip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
start_time_datetimecharacterTip-off, UTC; same value as start_time.
roundcharacterRound label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
match_typecharacterMatch type: regular, final (FINAL upper case seen)
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.
statuscharacterProvider fixture status: CONFIRMED, SCHEDULED.
home_scoreintegerUnobserved in samples (null in every capture); type and meaning unverified.
away_scoreintegerUnobserved in samples (null in every capture); type and meaning unverified.
attendanceintegerUnobserved in samples (null in every capture); type and meaning unverified.
match_slugcharacterURL slug of the match page on nbl.com.au.
match_titlecharacterMatch title (" v <men|women> DD-MM-YYYY")
venue_idcharacterDataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_namecharacterName of the venue (arena), e.g. RAC Arena.
venue_addresscharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_suburbcharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_statecharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_countrycharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_capacityintegerUnobserved in samples (null in every capture); type and meaning unverified.
venue_timezonecharacterIANA time zone of the venue, e.g. Australia/Sydney.
venue_codecharacterVenue code; often null.
venue_latitudenumericUnobserved in samples (null in every capture); type and meaning unverified.
venue_longitudenumericUnobserved in samples (null in every capture); type and meaning unverified.
home_team_idcharacterDataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
rosetta_home_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the home team; routes that take this entity accept it as well as the DataCore id.
home_team_namecharacterDisplay name of the team.
home_team_external_team_namecharacterTeam name as DataCore spells it.
home_team_codecharacterTeam code of the home team, e.g. PER or SYD.
home_team_divisioncharacterUnobserved in samples (null in every capture); type and meaning unverified.
home_team_conferencecharacterUnobserved in samples (null in every capture); type and meaning unverified.
away_team_idcharacterDataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
rosetta_away_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the away team; routes that take this entity accept it as well as the DataCore id.
away_team_namecharacterDisplay name of the team.
away_team_external_team_namecharacterTeam name as DataCore spells it.
away_team_codecharacterTeam code of the away team, e.g. PER or SYD.
away_team_divisioncharacterUnobserved in samples (null in every capture); type and meaning unverified.
away_team_conferencecharacterUnobserved in samples (null in every capture); type and meaning unverified.
season_idcharacterDataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_namecharacterSeason name (NBL26, WNBL 2024/25, 2025 South Men)
season_yearintegerRosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_typecharacterSeason type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_gendercharacterGender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_idcharacterRosetta competition id (UUID v4)
season_competition_namecharacterName of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gendercharacterGender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_league_namecharacterName of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_divisioncharacterAlways an empty array in samples; element shape and meaning unverified.
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.

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

Example​

nbl_rosetta_next_match(org='nbl', season=2027)

Last validated n/a.

nbl_rosetta_next_match_team​

Next match; the team segment is ignored by Rosetta (the body is the organisation's next match).

Endpoint URL: GET https://prod.rosetta.nbl.com.au/get/next/match/for/team/{team_code}/{org}/{season}

Valid URL: https://prod.rosetta.nbl.com.au/get/next/match/for/team/PER/nbl/2027

API ParameterPythonPatternRequiredNullableDescription
team_codeteam_codeYTeam code (team_code of nbl_rosetta_teams), e.g. PER for the Perth Wildcats.
orgorgYOrganisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences).
seasonseasonYSeason 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.

Returns​

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

col_nametypedescription
orgcharacterOrganisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
match_idcharacterDataCore fixture id (UUID v1); equal to id.
external_media_idcharacterMedia id. Through NBL25 (2024-25): the Genius Sports match id (7 digits, e.g. 2636769; 6 or fewer in older seasons). From NBL26: mostly an 8-digit number of unverified origin (e.g. 61386925), date-like codes on some games (05042026 = DDMMYYYY on the 2026 Championship game, 1409252 = DDMMYY + n on the Blitz), null on many preseason games. NBL1 and WNBL 2025 carry 8-digit numbers.
date_updatedcharacterRecord last-edit time, ISO 8601 UTC.
start_timecharacterTip-off, UTC, with no offset or a Z suffix (ESPN dates the same Perth v SE Melbourne game 2025-12-18T10:30Z; Rosetta says 2025-12-18T10:30:00)
start_time_datetimecharacterTip-off, UTC; same value as start_time.
roundcharacterRound label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP")
match_typecharacterMatch type: regular, final (FINAL upper case seen)
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.
statuscharacterProvider fixture status: CONFIRMED, SCHEDULED.
home_scoreintegerUnobserved in samples (null in every capture); type and meaning unverified.
away_scoreintegerUnobserved in samples (null in every capture); type and meaning unverified.
attendanceintegerUnobserved in samples (null in every capture); type and meaning unverified.
match_slugcharacterURL slug of the match page on nbl.com.au.
match_titlecharacterMatch title (" v <men|women> DD-MM-YYYY")
venue_idcharacterDataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes.
rosetta_venue_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the venue; routes that take this entity accept it as well as the DataCore id.
venue_namecharacterName of the venue (arena), e.g. RAC Arena.
venue_addresscharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_suburbcharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_statecharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_countrycharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_capacityintegerUnobserved in samples (null in every capture); type and meaning unverified.
venue_timezonecharacterIANA time zone of the venue, e.g. Australia/Sydney.
venue_codecharacterUnobserved in samples (null in every capture); type and meaning unverified.
venue_latitudenumericUnobserved in samples (null in every capture); type and meaning unverified.
venue_longitudenumericUnobserved in samples (null in every capture); type and meaning unverified.
home_team_idcharacterDataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes.
rosetta_home_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the home team; routes that take this entity accept it as well as the DataCore id.
home_team_namecharacterDisplay name of the team.
home_team_external_team_namecharacterTeam name as DataCore spells it.
home_team_codecharacterTeam code of the home team, e.g. PER or SYD.
home_team_divisioncharacterUnobserved in samples (null in every capture); type and meaning unverified.
home_team_conferencecharacterUnobserved in samples (null in every capture); type and meaning unverified.
away_team_idcharacterDataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes.
rosetta_away_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the away team; routes that take this entity accept it as well as the DataCore id.
away_team_namecharacterDisplay name of the team.
away_team_external_team_namecharacterTeam name as DataCore spells it.
away_team_codecharacterTeam code of the away team, e.g. PER or SYD.
away_team_divisioncharacterUnobserved in samples (null in every capture); type and meaning unverified.
away_team_conferencecharacterUnobserved in samples (null in every capture); type and meaning unverified.
season_idcharacterDataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes.
rosetta_season_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the season; routes that take this entity accept it as well as the DataCore id.
season_namecharacterSeason name (NBL26, WNBL 2024/25, 2025 South Men)
season_yearintegerRosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_typecharacterSeason type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_gendercharacterGender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
season_competition_idcharacterRosetta competition id (UUID v4)
season_competition_namecharacterName of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men).
season_competition_gendercharacterUnobserved in samples (null in every capture); type and meaning unverified.
season_competition_league_namecharacterName of the league the competition belongs to (NBL, WNBL or NBL1).
season_competition_divisioncharacterAlways an empty array in samples; element shape and meaning unverified.
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.

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

Example​

nbl_rosetta_next_match_team(org='nbl', season=2027, team_code='PER')

Last validated n/a.

nbl_rosetta_next_matches​

Each team's next matches: opponent, venue and start time.

Endpoint URL: GET https://prod.rosetta.nbl.com.au/get/next/matches/for/teams/in/{org}/{season}

Valid URL: https://prod.rosetta.nbl.com.au/get/next/matches/for/teams/in/nbl/2027

API ParameterPythonPatternRequiredNullableDescription
orgorgYOrganisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences).
seasonseasonYSeason 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.

Returns​

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

col_nametypedescription
orgcharacterOrganisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
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)
divisioncharacterUnobserved in samples (null in every capture); type and meaning unverified.
conferencecharacterUnobserved in samples (null in every capture); type and meaning unverified.
match_slugcharacterURL slug of the upcoming match, e.g. sydney-kings-v-nz-breakers-men-14-10-2026.
match_titlecharacterTitle of the upcoming match, e.g. Sydney Kings v NZ Breakers men 14-10-2026.
start_time_datetimecharacterStart of the upcoming match, UTC, ISO 8601 text without an offset.
is_homelogicalTrue when the row's team is the home team of the upcoming match.
opponent_namecharacterName of the opponent in the upcoming match.
venuecharacterName of the venue (arena) of the upcoming match.
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.
rosetta_opponent_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the opponent; routes that take this entity accept it as well as the DataCore id.
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.

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

Example​

nbl_rosetta_next_matches(org='nbl', season=2027)

Last validated n/a.