Skip to contents

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

Usage

nbl_rosetta_seasons(org = "nbl", limit = NULL)

Arguments

org

(character default "nbl"): 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 hoopR_data tibble with one row per season. Its columns are listed in return_columns (subset(return_columns, fn == "nbl_rosetta_seasons")) and in the searchable return columns article.

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; check them before you republish the data.

  • 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 hoopR_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 (hoopR_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 (hoopR_asset_fetch); retry after the cache entry expires.

Errors: hoopR_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); hoopR_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; hoopR_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

See also

family_nbl_rosetta lists every function in this family.

Examples

# \donttest{
  try(nbl_rosetta_seasons(org = "nbl"))
#> ── NBL Rosetta seasons from prod.rosetta.nbl.com.au ───────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:16:34 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>
# }