Games of a season (the whole season in one page): teams, score by period, officials, venue and top scorer.
Endpoint: GET https://api.basketball-bundesliga.de/games (DBBL: the same route on
https://api-1.dbbl.scb.world).
Usage
scb_games(
league = "bbl",
season = NULL,
competition = NULL,
game_type = NULL,
team_id = NULL,
page_size = 500
)Arguments
- league
(default
"bbl") League:bbl(men, easyCredit Basketball Bundesliga, api.basketball-bundesliga.de) ordbbl(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).- season
(default
NULL) Season END year (2026 = 2025-26, the sdv key). Sent to the API as its START-year seasonId (season - 1). Omitted = the season in progress.- competition
(default
NULL) Competition filter: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host. Omitted = all. The other host's competition answers an empty page.- game_type
(default
NULL) Finished, scheduled or all games. Omitted = all.- team_id
(default
NULL) Only the games of this team, home or guest (the club id equals the season-team id).- page_size
(default
500) Rows per page. The wrapper reads page 1 and refuses a result that needs more pages, so keep it large enough for the whole result (500 covers a season).
Value
A hoopR_data tibble with one row per game.
Its columns are listed in return_columns
(subset(return_columns, fn == "scb_games")) and in the searchable
return columns article.
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in scb_seasons().
See also
family_scb lists every function in this family.
Examples
# \donttest{
try(scb_games())
#> ── BBL/DBBL Games from the SCB API ────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:17:01 UTC
#> # A tibble: 325 × 89
#> league season season_id game_id competition stage status scheduled_time
#> <chr> <int> <int> <chr> <chr> <chr> <chr> <chr>
#> 1 bbl 2027 2026 2006720 BBL_CUP FIRST_ROUND OFFIC… 2026-09-10T16…
#> 2 bbl 2027 2026 2006724 BBL_CUP FIRST_ROUND OFFIC… 2026-09-10T18…
#> 3 bbl 2027 2026 2006728 BBL_CUP FIRST_ROUND OFFIC… 2026-09-11T18…
#> 4 bbl 2027 2026 2006722 BBL_CUP FIRST_ROUND OFFIC… 2026-09-12T16…
#> 5 bbl 2027 2026 2006721 BBL_CUP FIRST_ROUND OFFIC… 2026-09-12T18…
#> 6 bbl 2027 2026 2006723 BBL_CUP FIRST_ROUND OFFIC… 2026-09-13T13…
#> 7 bbl 2027 2026 2006727 BBL_CUP FIRST_ROUND OFFIC… 2026-09-13T14…
#> 8 bbl 2027 2026 2006725 BBL_CUP FIRST_ROUND OFFIC… 2026-09-13T16…
#> 9 bbl 2027 2026 2006920 BBL MAIN_ROUND OFFIC… 2026-09-18T18…
#> 10 bbl 2027 2026 2006923 BBL MAIN_ROUND OFFIC… 2026-09-19T16…
#> # ℹ 315 more rows
#> # ℹ 81 more variables: match_day <int>, is_tbd <lgl>, is_hidden <lgl>,
#> # home_team_id <chr>, home_season_team_id <chr>, home_team_name <chr>,
#> # home_tlc <chr>, home_is_foreign <lgl>, home_rank <int>, home_streak <chr>,
#> # home_streak_count <int>, home_last10_victories <int>,
#> # home_last10_losses <int>, home_total_games <int>, guest_team_id <chr>,
#> # guest_season_team_id <chr>, guest_team_name <chr>, guest_tlc <chr>, …
# }
