Every season of an organisation: regular, preseason, in-season cups and test seasons, with dates.
Endpoint: GET https://prod.rosetta.nbl.com.au/get/{org}/seasons
Arguments
- 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".- limit
(integer default
NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).
Value
A wehoop_data tibble (one row per season):
| col_name | type | description |
| org | character | Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request. |
| season_id | character | DataCore season id (UUID v1); accepted as {season_id}. |
| rosetta_season_id | character | Rosetta season id (UUID v4; v5 on NBL1); the {season_id} route key. |
| name | character | Season name as Rosetta spells it (NBL26, WNBL 2024/25, 2025 South Men); names drift, key on season_year. |
| season_year | integer | Rosetta'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_type | character | Season type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test. |
| start_date | character | First day of the season, ISO date-time without offset. |
| end_date | character | Last day of the season, ISO date-time without offset; null on older seasons. |
| competition_league_name | character | Name of the league the season's competition belongs to (NBL, WNBL or NBL1). |
| competition_division | character | NBL1 divisions (conference x gender); empty for NBL and WNBL. |
| season_end_year | integer | sdv 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.
See also
Other NBL Rosetta Functions:
nbl_rosetta_match(),
nbl_rosetta_match_by_id(),
nbl_rosetta_match_pbp(),
nbl_rosetta_match_player_box(),
nbl_rosetta_match_player_period_box(),
nbl_rosetta_match_team_box(),
nbl_rosetta_matches(),
nbl_rosetta_next_match(),
nbl_rosetta_next_match_team(),
nbl_rosetta_next_matches(),
nbl_rosetta_outcomes(),
nbl_rosetta_player_game_log(),
nbl_rosetta_player_stats(),
nbl_rosetta_players(),
nbl_rosetta_seasons_current(),
nbl_rosetta_standings(),
nbl_rosetta_stats_leaders(),
nbl_rosetta_team_players(),
nbl_rosetta_team_stats(),
nbl_rosetta_team_stats_leaders(),
nbl_rosetta_teams()
Examples
# \donttest{
try(nbl_rosetta_seasons(org = "nbl"))
#> ── NBL Rosetta seasons from prod.rosetta.nbl.com.au ──────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:37:11 UTC
#> # A tibble: 75 × 11
#> org season_id rosetta_season_id name season_year season_type start_date
#> <chr> <chr> <chr> <chr> <int> <chr> <chr>
#> 1 nbl 1b041b7b-3d… 67d4a190-40bc-4b… NBL27 2026 regular 2026-09-1…
#> 2 nbl 75edbf66-fd… 45d43145-9958-42… Test… 2026 test 2026-01-0…
#> 3 nbl dcd2dfb6-3d… ec19e36d-dcc9-43… NBL2… 2026 preseason 2026-08-0…
#> 4 nbl a678a0a7-58… 7a6377b7-9610-4e… Code… 2026 in_season 2026-09-0…
#> 5 nbl 31b61cc0-8d… 9554cfd7-a980-48… Pavl… 2025 in_season 2025-09-1…
#> 6 nbl 9a761374-41… 1f8e4a79-e98b-45… NBL26 2025 regular 2025-09-1…
#> 7 nbl NA 2abf3927-fd9b-43… NBAx… 2025 in_season 2025-10-0…
#> 8 nbl cf6ef1c7-fb… 4fb9aabf-b247-4c… Igni… 2025 regular 2026-02-2…
#> 9 nbl b0a15fff-47… 004cb804-31c0-4e… NBL2… 2025 preseason 2025-08-0…
#> 10 nbl e558c885-47… 09b360cf-23f2-42… CODE… 2025 in_season 2025-08-2…
#> # ℹ 65 more rows
#> # ℹ 4 more variables: end_date <chr>, competition_league_name <chr>,
#> # competition_division <chr>, season_end_year <int>
# }