A club's players and staff for an edition (default: the current one).
One row per person; role is player or staff (head coach and assistants). person_id is the ACB licence
number (a player's player_id). height_cm is the player's height in centimetres (null for staff); age
is the age now; nationality is Spanish and nationality_iso its ISO alpha-2 code. temporary_roster is
true while the roster is provisional. Absence lists are not parsed.
Endpoint: GET https://api2.acb.com/api/seasondata/TeamProfile/current-roster
Arguments
- club_id
(required) ACB club id (integer), stable across seasons and sponsor names (2 = Barca, 9 = Real Madrid, 13 = Valencia Basket). Not the season-team
team_id. A whole number; a whole double is accepted.- competition_id
(default
NULL) Competition id: 1 Liga Endesa, 2 Copa del Rey, 3 Supercopa Endesa, 10 Minicopa Endesa (youth). Omitted = the API's default competition. A whole number; a whole double is accepted.- season
(default
NULL) Season END year (2027 = 2026-27; the first ACB season, 1983-84, is 1984).acb_runtimesends the API'seditionId= season - 1936. Omitted = the current season. A whole number; a whole double is accepted.
Value
A hoopR_data tibble, one row per record described above; the columns are always these, in this order
(sportsdataverse-py acb_current_roster):
| col_name | type | description |
| club_id | integer | Stable club id asked for (the body names no club). |
| role | character | player or staff (head coach and assistants). |
| person_id | integer | ACB licence number of the person; a player's player_id elsewhere. |
| person_name | character | Display name as the site shows it. |
| first_name | character | First name(s); null when the API does not send it. |
| last_name | character | Last name(s); null when the API does not send it. |
| shirt_number | character | Shirt number as a string; null for staff. |
| game_role | character | Position or staff role in Spanish (Base, Escolta, Alero, Ala-pivot, Pivot; Entrenador, Segundo Entrenador). |
| licensing | character | Licence code (for example EUR, JFL, CRE); meaning unverified. |
| age | integer | Age in years as sent by the roster route. |
| nationality | character | Nationality as sent, a Spanish country name ('Serbia', 'EE.UU.'). |
| nationality_iso | character | ISO 3166-1 alpha-2 code of nationality, from the 31 observed names; null for an unseen name. |
| height_cm | integer | Height in centimetres (players only). |
| is_license_active | logical | True when the licence is active in the current season. |
| edition_id | integer | Season id the person record was read for (START year - 1935). |
| season | integer | Season END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take. |
| temporary_roster | logical | True while the roster is provisional. |
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in acb_match_header().
See also
Other ACB Functions:
acb_box_info(),
acb_bracket(),
acb_bracket_games(),
acb_calendar(),
acb_career_stints(),
acb_career_trophies(),
acb_club_data(),
acb_competition_current(),
acb_competition_editions(),
acb_competition_rounds(),
acb_competition_weeks(),
acb_lead_stats(),
acb_lead_tracker(),
acb_league_zones(),
acb_lineup(),
acb_match_advanced_stats(),
acb_match_header(),
acb_match_leaders(),
acb_matchlist(),
acb_next_matches(),
acb_pbp(),
acb_period_scores(),
acb_player_advanced_stats(),
acb_player_box(),
acb_player_data(),
acb_player_matches(),
acb_player_stats(),
acb_player_totals(),
acb_quickfacts(),
acb_round_matches(),
acb_search(),
acb_season_leaders(),
acb_serie(),
acb_shots(),
acb_standings(),
acb_standings_rounds(),
acb_team_box(),
acb_team_comparison(),
acb_team_leaders(),
acb_team_matches(),
acb_team_records(),
acb_team_stats(),
acb_team_totals(),
acb_teams()
Examples
# \donttest{
try(acb_current_roster(club_id = 2, season = 2027))
#> ── ACB Current Roster from api2.acb.com ───────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:26:30 UTC
#> # A tibble: 19 × 17
#> club_id role person_id person_name first_name last_name shirt_number
#> <int> <chr> <int> <chr> <chr> <chr> <chr>
#> 1 2 player 30003361 Kevin Punter Kevin Punter 0
#> 2 2 player 30005355 Umoja Gibson Umoja Gibson 1
#> 3 2 player 30005378 Tyrese Martin Tyrese Martin 2
#> 4 2 player 30005361 Stanley Umude Stanley Umude 3
#> 5 2 player 30003340 Justin Robinson Justin Robinson 5
#> 6 2 player 20209919 Darío Brizuela Darío Brizuela 8
#> 7 2 player 30001332 Agustín Ubal Agustín Ubal 10
#> 8 2 player 30005357 Olivier Nkamhoua Olivier Nkamhoua 13
#> 9 2 player 30000093 Juan Núñez Juan Núñez 17
#> 10 2 player 30005377 Tosan Evbuomwan Torisesan Evbuomwan 20
#> 11 2 player 20212243 Olek Balcerowski Aleksander Balcerow… 22
#> 12 2 player 30005476 Justin Minaya Justin Minaya 24
#> 13 2 player 30005356 Josh Nebo Joshua Nebo 32
#> 14 2 player 30004606 J. Siftar Jakob Siftar 42
#> 15 2 player 20212265 Joel Parra Joel Parra 44
#> 16 2 player 30005447 Yoan Makoundou Yoan Makoundou 55
#> 17 2 staff 30005390 Aleksander Sekulic Aleksander Sekulic 1
#> 18 2 staff 30005459 Jurica Zuza Jurica Zuza 2
#> 19 2 staff 30005460 Jernej Valentincic Jernej Valentin… 3
#> # ℹ 10 more variables: game_role <chr>, licensing <chr>, age <int>,
#> # nationality <chr>, nationality_iso <chr>, height_cm <int>,
#> # is_license_active <lgl>, edition_id <int>, season <int>,
#> # temporary_roster <lgl>
# }