Skip to contents

Roster of one team in a season: player bio, jersey and position.

Endpoint: GET https://prod.rosetta.nbl.com.au/get/{org}/players/for/team/{team_id}/in/season/{season}

Usage

nbl_rosetta_team_players(team_id, season, org = "nbl")

Arguments

team_id

(character required): Team id: the DataCore id (team_id of nbl_rosetta_teams) or Rosetta's own id; either is accepted.

season

(integer required): Season 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.

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".

Value

A hoopR_data tibble (one row per roster entry):

col_nametypedescription
orgcharacterOrganisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
jersey_numbercharacterJersey number, a STRING.
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.
team_namecharacterName of the team as Rosetta spells it, e.g. Perth Wildcats.
team_codecharacterTeam code, e.g. PER (the {team_code} path value)
team_gendercharacterGender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
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_full_namecharacterGiven and family name.
player_jersey_numbercharacterJersey number, a STRING.
player_playing_positioncharacterPlaying position code (G, F, C, PG, SF, FC, ...); null when not recorded.
player_activelogicalPlayer record is active.
player_date_of_birthcharacterDate of birth, ISO date.
player_nationalitycharacterUnobserved in samples (null in every capture); type and meaning unverified.
player_heightdoubleHeight in centimetres.
player_weightdoubleWeight in kilograms.
player_dominant_handcharacterUnobserved in samples (null in every capture); type and meaning unverified.
player_gendercharacterGender (MALE/FEMALE upper case on seasons and players, male/female lower case on competitions and divisions; UNKNOWN seen)
player_nationality_codecharacterNationality, ISO 3166-1 alpha-3 code.
player_birthplacecharacterUnobserved in samples (null in every capture); type and meaning unverified.
player_rookie_yearcharacterUnobserved in samples (null in every capture); type 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.

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().

 nbl_rosetta_team_players(
   org = "nbl", season = 2026, team_id = "befee10a-410c-11f0-b3f4-1b3c55488bbb"
 )