Skip to contents

Roster of one competition team (current entries only).

Endpoint: GET https://bnxt.sportpress.info/api/v1/roster/team-players/{competition_team_id}

Usage

sportpress_team_roster(competition_team_id)

Arguments

competition_team_id

(required) Competition-team id (integer): a team in ONE competition, so new every season (e.g. 541 = Antwerp in 2026-27); from sportpress_competition_teams().

Value

A hoopR_data tibble: Roster of one competition team (current entries only). An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py sportpress_team_roster):

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; the lists hold current entries only.
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.

Details

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

 sportpress_team_roster(competition_team_id = 541)