One match's header: status, scores, clock, venue, season and teams. Box score and play-by-play: the match_* frames.
Endpoint: GET https://prod.rosetta.nbl.com.au/get/match/{match_id}/live/all
Value
A hoopR_data tibble (one row):
| col_name | type | description |
| org | character | Organisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request. |
| match_id | character | DataCore fixture id (UUID v1); equal to id. |
| match_status | character | Status of the match in Rosetta's words (complete for a finished game): box score and play-by-play of any other status are partial. |
| start_time_datetime | character | Tip-off, UTC; same value as start_time. |
| match_type | character | Match type: regular, final (FINAL upper case seen) |
| attendance | integer | Attendance, a STRING; null when not recorded. |
| clock | character | Game clock of the latest event, HH:MM:SS remaining in the period. |
| current_period | integer | Latest period number as a STRING; null on older matches. |
| clock_running | logical | Game clock is running. |
| home_score | integer | Home final score, a STRING; null before tip-off. |
| away_score | integer | Away final score, a STRING; null before tip-off. |
| round | character | Round label: a number as a string in the regular season ("13"), words in the finals ("SEMI FINAL SERIES 1", "CHAMPIONSHIP") |
| start_time | character | Tip-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) |
| status | character | Provider fixture status: CONFIRMED, SCHEDULED. |
| external_media_id | character | Media 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. |
| match_slug | character | URL slug of the match page on nbl.com.au. |
| match_title | character | Match title ("<home> v <away> <men/women> DD-MM-YYYY") |
| secondary_external_id | character | Unobserved in samples (null in every capture); type and meaning unverified. |
| live_exclusive | logical | Match is a live-stream exclusive. |
| season_id | character | DataCore id (UUID v1, Sportradar) of the season; stable across seasons and the id to join on across routes. |
| rosetta_season_id | character | Rosetta'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_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. |
| season_competition_id | character | Rosetta competition id (UUID v4) |
| season_competition_name | character | Name of the competition the season belongs to (e.g. NBL, WNBL, NBL1 North Men). |
| season_competition_gender | character | Gender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen) |
| season_competition_league_name | character | Name of the league the competition belongs to (NBL, WNBL or NBL1). |
| season_competition_division | character | NBL1 divisions (conference x gender); empty for NBL and WNBL. |
| venue_id | character | DataCore id (UUID v1, Sportradar) of the venue; stable across seasons and the id to join on across routes. |
| rosetta_venue_id | character | Rosetta'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_name | character | Name of the venue (arena), e.g. RAC Arena. |
| venue_address | character | Unobserved in samples (null in every capture); type and meaning unverified. |
| venue_capacity | integer | Unobserved in samples (null in every capture); type and meaning unverified. |
| venue_timezone | character | IANA time zone of the venue, e.g. Australia/Sydney. |
| venue_code | character | Venue code; often null. |
| venue_state | character | Unobserved in samples (null in every capture); type and meaning unverified. |
| venue_suburb | character | Unobserved in samples (null in every capture); type and meaning unverified. |
| venue_latitude | double | Unobserved in samples (null in every capture); type and meaning unverified. |
| venue_longitude | double | Unobserved in samples (null in every capture); type and meaning unverified. |
| venue_country | character | Country; often null. |
| home_team_id | character | DataCore id (UUID v1, Sportradar) of the home team; stable across seasons and the id to join on across routes. |
| home_team_name | character | Display name of the team. |
| home_team_external_team_name | character | Team name as DataCore spells it. |
| home_team_code | character | Team code of the home team, e.g. PER or SYD. |
| away_team_id | character | DataCore id (UUID v1, Sportradar) of the away team; stable across seasons and the id to join on across routes. |
| away_team_name | character | Display name of the team. |
| away_team_external_team_name | character | Team name as DataCore spells it. |
| away_team_code | character | Team code of the away team, e.g. PER or SYD. |
| data_source | character | Backend that built the body: nexus-api or lambda-cache (observed). It varies between requests for the same match (the NBL 2025-26 sample game came back lambda-cache from /live/all and nexus-api from /match/{match_id} minutes apart, with identical play-by-play), so it says nothing about the data. |
| match_status_string | character | Status banner text, e.g. FINAL. |
| play_by_play_updated_datetime | character | Last play-by-play update, ISO 8601 UTC. |
| 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 (sportsdataverse-py keeps them too).
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in nbl_rosetta_seasons().
See also
Other NBL Rosetta Functions:
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(),
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_match(match_id = "b217a699-4bef-11f0-bc08-933162362355"))
#> ── NBL Rosetta match from prod.rosetta.nbl.com.au ─────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:32:56 UTC
#> # A tibble: 1 × 52
#> org match_id match_status start_time_datetime match_type attendance clock
#> <chr> <chr> <chr> <chr> <chr> <int> <chr>
#> 1 nbl b217a699-4… complete 2025-12-18T10:30:00 regular 10802 00:0…
#> # ℹ 45 more variables: current_period <int>, clock_running <lgl>,
#> # home_score <int>, away_score <int>, round <chr>, start_time <chr>,
#> # status <chr>, external_media_id <chr>, match_slug <chr>, match_title <chr>,
#> # secondary_external_id <chr>, live_exclusive <lgl>, season_id <chr>,
#> # rosetta_season_id <chr>, season_year <int>, season_type <chr>,
#> # season_competition_id <chr>, season_competition_name <chr>,
#> # season_competition_gender <chr>, season_competition_league_name <chr>, …
# }