Roster of one team-season with games, minutes and per-game points and efficiency (birth dates dropped).
Endpoint: GET https://miniappapi.tbf.org.tr/webapi-service/api/Team/get-team-active-player-list-by-season-and-league
Arguments
- season
Required. Season END year (2027 = the 2026-2027 season). TBF keys a league-season by internal season and activity ids; the runtime reads them from the league's season list by the END year of the label. A year the list lacks raises
hoopR_no_data.- team_process_id
Required. Team-season id (team registration), e.g. 265995 = Tofas in BSL 2026-27; team_process_id in
tbf_teams()andtbf_schedule(). New for every club in every league-season; not the stable club_id.- competition
TBF league: bsl (Basketbol Super Ligi), tbl (second tier) or kbsl (women's Super Ligi). The top flight was named TBL until 2007-08 and is listed under bsl.
Value
A hoopR_data tibble. One row per rostered person. Birth dates are not returned.
Every column below is always present (a zero-row tibble keeps them and their types); an answer
with nothing in it raises hoopR_no_data, as in sportsdataverse-py.
| col_name | type | description |
| season | integer | Season END year (2027 = the 2026-2027 season), read from the 'YYYY-YYYY' label or the request; the sdv season key. Not the internal TBF season id (season_id). |
| competition | character | TBF league the row belongs to: bsl, tbl or kbsl (the request's competition, or the league prefix the API reports). |
| team_process_id | integer | Team-season id of the request (key space: TBF team registrations). |
| person_id | integer | TBF person id (personId; key space: TBF persons). |
| first_name | character | Given name as registered with TBF, mixed case ('Yigitcan'). |
| last_name | character | Family name as registered with TBF, mixed case ('Saybir'). |
| nationality | character | Nationality as a TURKISH country name (country); there is no code on this route. |
| height_cm | integer | Height in centimetres; null when TBF has none. |
| jersey_number | character | Shirt number as a string, so '0' and '00' stay distinct. |
| games | integer | Games played (macSayisi = game count). |
| seconds_played | integer | Season time on court in seconds (sure 'hh:mm:ss'). |
| points_per_game | double | Points per game (sayi). |
| efficiency_per_game | double | Efficiency rating per game (verimlilikPuani). |
Details
Official TBF app API, unofficial for SportsDataverse: the backend of the Turkish Basketball Federation's mobile app (miniappapi.tbf.org.tr), which serves BSL, TBL, KBSL and the other TBF leagues. It needs no key; robots.txt answers 404 on the host, and the runtime spaces requests at least 1 s apart. TBF's terms were not reviewed; check them before you republish the data. The vendor's origin hosts (nikayazilim.com) serve the same data without Cloudflare but are deliberately not used, redirects are never followed, and www.tbf.org.tr's interactive Turnstile is neither used nor automated.
Coverage: season and competition are parameters (bsl Basketbol Super Ligi, back to 1966-67 in the league
list; tbl second tier; kbsl women, both from 2015-16). Game wrappers serve FINISHED games only (an
unfinished game raises hoopR_asset_fetch). Box scores exist from 2006-07 (no starters flagged that
season); play-by-play and shots from 2025-26 only, an earlier finished game raises hoopR_no_data. Every
game carries a Genius LiveStats id (genius_id, joins the genius family) from 2018-19 on some seasons
and on every game of 2025-26 and later. Birth dates, contact details, photos and logos are dropped. Names
and category labels are Turkish; the column descriptions give the English gloss.
Errors: hoopR_no_data when TBF has nothing for the request (HTTP 404, an unknown game or player, a season
the league list lacks, an empty list, a finished game before 2025-26 asked for play-by-play or shots);
hoopR_bad_request for an invalid argument or HTTP 400 / 422; hoopR_asset_fetch when the fetch failed or
the answer is not the one asked for (an unfinished game, a body for another game, season, league or team,
an error envelope, a redirect, a partial page or a changed capped list). All inherit hoopR_error.
Timestamps are Turkey local time (Europe/Istanbul).
See also
Other TBF Functions:
tbf_daily_matches(),
tbf_game_header(),
tbf_game_leaders(),
tbf_game_players(),
tbf_highlights(),
tbf_leaders_assists(),
tbf_leaders_blocks(),
tbf_leaders_efficiency(),
tbf_leaders_minutes(),
tbf_leaders_points(),
tbf_leaders_rebounds(),
tbf_leaders_steals(),
tbf_leaders_threes(),
tbf_leaders_turnovers(),
tbf_league_seasons(),
tbf_leagues(),
tbf_pbp(),
tbf_period_scores(),
tbf_player_box(),
tbf_player_career(),
tbf_players(),
tbf_schedule(),
tbf_seasons(),
tbf_shots(),
tbf_standings(),
tbf_team_box(),
tbf_team_games(),
tbf_team_player_stats(),
tbf_team_staff(),
tbf_teams(),
tbf_weeks()
Examples
# \donttest{
try(tbf_team_roster(season = 2027, team_process_id = 265995))
#> ── TBF Team Roster ────────────────────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:34:59 UTC
#> # A tibble: 17 × 13
#> season competition team_process_id person_id first_name last_name nationality
#> <int> <chr> <int> <int> <chr> <chr> <chr>
#> 1 2027 bsl 265995 395705 Berkay Gönül TÜRKİYE
#> 2 2027 bsl 265995 778401 Bryce Jones ABD
#> 3 2027 bsl 265995 389934 Efe Postel TÜRKİYE
#> 4 2027 bsl 265995 434482 Emirhan Serbest TÜRKİYE
#> 5 2027 bsl 265995 778398 Gabe Brown ABD
#> 6 2027 bsl 265995 508900 Jamuni McNeace ABD
#> 7 2027 bsl 265995 381976 Karahan Efeoğlu TÜRKİYE
#> 8 2027 bsl 265995 452216 Kerem Çorumlul… TÜRKİYE
#> 9 2027 bsl 265995 197570 Leon Apaydın TÜRKİYE
#> 10 2027 bsl 265995 450092 Poyraz Paşaoğlu TÜRKİYE
#> 11 2027 bsl 265995 227173 Sadık Kabaca TÜRKİYE
#> 12 2027 bsl 265995 778399 Shavar Reynolds… ABD
#> 13 2027 bsl 265995 450651 Soykan Bağadır TÜRKİYE
#> 14 2027 bsl 265995 485299 Terrell Carter II ABD
#> 15 2027 bsl 265995 736069 Tre'shawn Thurman ABD
#> 16 2027 bsl 265995 196413 Yiğitcan Saybir TÜRKİYE
#> 17 2027 bsl 265995 778402 Zach Nutall ABD
#> # ℹ 6 more variables: height_cm <int>, jersey_number <chr>, games <int>,
#> # seconds_played <int>, points_per_game <dbl>, efficiency_per_game <dbl>
# }