Skip to contents

One roster entry with its player, team and season.

Endpoint: GET https://bnxt.sportpress.info/api/v1/roster/find/{roster_id}

Usage

sportpress_roster_find(roster_id)

Arguments

roster_id

(required) Roster id (integer): one player on one team in one season; from the roster frames.

Value

A hoopR_data tibble: One roster entry with its player, team and season. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py sportpress_roster_find):

col_nametypedescription
roster_idintegerRoster id (key space: sportpress roster entries): one player on one competition team in one season, so a player has a new roster_id for every team and season. player_id is the person.
competition_team_idintegerCompetition-team id (key space: sportpress competition teams): a team in ONE competition, so a club has a new id every season (Antwerp = 3 in 2021-22, 506 in 2025-26, 541 in 2026-27). uu_team_id is the stable club key.
jerseycharacterShirt number as text; the box score sends it as an integer, so a zero-padded '00' is already lost there.
weightintegerWeight in kg; null when unknown.
heightintegerHeight in cm; null when unknown.
activelogicalTrue for a current roster entry; former entries are false.
position_idintegerPosition id (key space: sportpress positions; 3 = small_forward).
positioncharacterPosition code: point_guard, shooting_guard, small_forward, power_forward, center, and the hybrids point_guard-shooting_guard, shooting_guard-small_forward, small_forward-power_forward, power_forward-center.
player_idintegerPlayer id (key space: sportpress persons): stable across seasons and teams, distinct from roster_id. Not a Genius or FIBA person id.
first_namecharacterGiven name of the player as entered in the CMS.
last_namecharacterFamily name of the player as entered in the CMS.
nationality_codecharacterNationality code in FIBA style (USA, BEL, NED): DIRTY, with lower-case variants, '/'-joined pairs (USA/BEL), the empty string and 'HOL'; normalise before joining.
birth_dateDateDate of birth as shown on the public player page; null when unknown.
uu_team_idintegerStable club key across seasons of the team.
teamcharacterTeam display name including the sponsor.
team_short_namecharacterThree-letter club code of the team.
competition_idintegerCompetition id the roster entry's team plays in.
seasonintegerSeason END year of the roster entry's competition.

Details

Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in sportpress_ui_strings().

 sportpress_roster_find(roster_id = 11193)