Get BBL / DBBL Playoff Series

Playoff bracket of a season: one row per series (quarter-finals, semi-finals, finals).

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

Usage

scb_playoff_series(season, league = "dbbl")

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 "dbbl", the women's DBBL) 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 wehoop_data tibble: Playoff bracket of a season: one row per series (quarter-finals, semi-finals, finals). An empty valid answer raises wehoop_no_data; the columns are always these, in this order (sdv-py scb_playoff_series):

col_name	type	description
league	character	League the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
season	integer	Season END year (2026 = 2025-26), the sdv key; the API's season_id plus one.
season_id	integer	Season, START year (2026 = 2026-27).
round	character	Round of the bracket: quarter_finals, semi_finals or finals.
series	integer	1-based position of the series within its round, in the order the API lists them.
match_winner_id	character	Season-team id of the series winner, a string (the playoff tree sends an integer).
is_match_finished	logical	The series is decided.
team_a_id	character	Season-team id of series team A (the higher seed is A), a string (the playoff tree sends it as an integer); equals the club team id.
team_a_name	character	Name of series team A (the higher seed is A) as listed that season.
team_a_tlc	character	Three-letter club code of series team A (the higher seed is A).
team_a_rank	integer	Regular-season table position (the seed) of series team A (the higher seed is A).
team_a_victories	integer	Series wins of team A.
team_b_id	character	Season-team id of series team B (the higher seed is A), a string (the playoff tree sends it as an integer); equals the club team id.
team_b_name	character	Name of series team B (the higher seed is A) as listed that season.
team_b_tlc	character	Three-letter club code of series team B (the higher seed is A).
team_b_rank	integer	Regular-season table position (the seed) of series team B (the higher seed is A).
team_b_victories	integer	Series wins of team B.
games	integer	Games of the series.

Details

• Unofficial use of a public source: these wrappers read the front-end API of the German Bundesliga sites (easycredit-bbl.de, toyota-dbbl.de), run by SCB; payloads are not redistributed as release assets.

• Legal notice: the BBL Impressum forbids storing BBL content (Inhalte) in an information system without BBL's written permission. That is a copyright term, not a robots rule (the API host has no robots.txt). The owner reviewed it and accepted the intake (2026-10-12 ruling); keep requests slow (the runtime waits at least 1 s per host) and raise any published data release with the owner. The DBBL host is the same operator and API; its site notice was not separately reviewed.

• Both hosts need two headers: a constant x-api-key and an x-api-secret that rotates. The runtime derives the secret on first use from the key embedded in an easycredit-bbl.de page (reversed, : turned into -) and never logs or returns it. The derivation was reverse-engineered from observed requests and responses and has not been checked against the site's own front-end code; if the site changes how it signs requests, every call fails with wehoop_asset_fetch.

• Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year season is sent as season - 1. Teams are keyed by teamId (seasonTeamId equals it in every sample). seasonPlayerId is per player per season and per club (a player traded mid-season has two); realPlayerId is the person. playerId is ambiguous (the seasonPlayerId in box scores, records and /season-players; the person in /transfers). Game ids are strings.

• Errors are classed conditions: wehoop_no_data (404, 204, a 400 "not a valid" id, no rows, a box score of a game not yet started), wehoop_bad_request (a bad argument, another 400 / 422) and wehoop_asset_fetch (a refused secret after one re-derive, any other non-2xx, an HTML / non-JSON / error-shaped body, a truncated page, a body for another game, season, club or league, a box score still in play), all inheriting wehoop_error. Wrappers raise; they never return an empty frame.

 scb_playoff_series(season = 2026)

See also

Other SCB Functions: scb_game(), scb_game_actions(), scb_game_players(), scb_game_teams(), scb_games(), scb_games_recent(), scb_player_statistics(), scb_playoff_games(), scb_records_per_game(), scb_records_season_averages(), scb_referees(), scb_season_player(), scb_season_players(), scb_season_teams(), scb_seasons(), scb_standings(), scb_team(), scb_team_rosters(), scb_team_seasons(), scb_team_statistics(), scb_transfers(), scb_transfers_teams()