Skip to contents

Every team of a season: club id, season-team id, name and three-letter code.

Endpoint: GET https://api.basketball-bundesliga.de/seasons/{season} (DBBL: the same route on https://api-1.dbbl.scb.world).

Usage

scb_season_teams(season, league = "bbl")

Arguments

season

(required) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1).

league

(default "bbl") League: bbl (men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) or dbbl (women, Toyota Damen-Basketball-Bundesliga, api-1.dbbl.scb.world). The two share one API; game ids overlap, so a game is (league, game_id).

Value

A hoopR_data tibble: Every team of a season: club id, season-team id, name and three-letter code. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py scb_season_teams):

col_nametypedescription
leaguecharacterLeague the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
seasonintegerSeason END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_idintegerThe API's own season key, the START year (2025 = 2025-26); season minus one.
team_idcharacterClub id; equal to seasonTeamId in every sample. Joins to /teams/{teamId}.
season_team_idcharacterSeason-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026).
team_namecharacterTeam name as listed that season (sponsor names included).
tlccharacterThree-letter club code.
logo_urlcharacterLogo image URL (per season).

Details

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

Examples

# \donttest{
  try(scb_season_teams(season = 2026))
#> ── BBL/DBBL Season Teams from the SCB API ─────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:33:48 UTC
#> # A tibble: 18 × 8
#>    league season season_id team_id season_team_id team_name       tlc   logo_url
#>    <chr>   <int>     <int> <chr>   <chr>          <chr>           <chr> <chr>   
#>  1 bbl      2026      2025 488     488            MLP Academics … HDB   https:/…
#>  2 bbl      2026      2025 413     413            ALBA BERLIN     BER   https:/…
#>  3 bbl      2026      2025 486     486            FC Bayern Münc… FCB   https:/…
#>  4 bbl      2026      2025 420     420            BMA365 Bamberg… BAM   https:/…
#>  5 bbl      2026      2025 415     415            Telekom Basket… BON   https:/…
#>  6 bbl      2026      2025 540     540            Fitness First … WUE   https:/…
#>  7 bbl      2026      2025 418     418            ratiopharm ulm  ULM   https:/…
#>  8 bbl      2026      2025 541     541            RASTA Vechta    VEC   https:/…
#>  9 bbl      2026      2025 414     414            VET-CONCEPT Gl… TRI   https:/…
#> 10 bbl      2026      2025 551     551            ROSTOCK SEAWOL… HRO   https:/…
#> 11 bbl      2026      2025 433     433            MHP RIESEN Lud… LUD   https:/…
#> 12 bbl      2026      2025 430     430            EWE Baskets Ol… OLD   https:/…
#> 13 bbl      2026      2025 485     485            NINERS Chemnitz CHE   https:/…
#> 14 bbl      2026      2025 428     428            SYNTAINICS MBC  MBC   https:/…
#> 15 bbl      2026      2025 554     554            Veolia Towers … HAM   https:/…
#> 16 bbl      2026      2025 426     426            SKYLINERS       FRS   https:/…
#> 17 bbl      2026      2025 483     483            Science City J… JEN   https:/…
#> 18 bbl      2026      2025 422     422            Basketball Löw… BRA   https:/…
# }