League table of a season: record, home / away split, streaks and tie-break detail (2005-06 on).
Endpoint: GET https://api.basketball-bundesliga.de/standings (DBBL: the same route on
https://api-1.dbbl.scb.world).
Arguments
- league
(default
"dbbl", the women's DBBL) 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. Seasons before about 2000 answer an empty table.- competition
(default
NULL) Competition: BBL, BBL_CUP, ALLSTAR, CHAMPIONS_CUP (BBL host) or DBBL, DBBL_CUP (DBBL host). BBL_CUP answers an empty table.
Value
A wehoop_data tibble: League table of a season: record, home / away split, streaks and tie-break detail
(2005-06 on). An empty valid answer raises wehoop_no_data; the columns are always these, in this order
(sdv-py scb_standings):
| 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. |
| standing_id | character | Opaque id of the standings row, a string. |
| season_team_id | character | Season-team id; equal to the club teamId in every sample (BBL 2005-2026, DBBL 2024-2026). An integer here. |
| team_id | character | Club id; equal to seasonTeamId in every sample. Joins to /teams/{teamId}. |
| team_name | character | Team name; null on some rows. |
| team_tlc | character | Three-letter club code. |
| team_name_short | character | Short team name (null on DBBL). |
| has_reached_playoffs | logical | Clinched a playoff place. |
| has_reached_playins | logical | Clinched at least the play-ins. |
| is_relegation_certain | logical | Relegated for certain. |
| season_id | integer | Season, START year (2026 = 2026-27). |
| competition | character | Competition: BBL, BBL_CUP (Pokal), ALLSTAR, CHAMPIONS_CUP on the BBL host; DBBL, DBBL_CUP on the DBBL host. |
| stage | character | Stage: MAIN_ROUND (Hauptrunde, regular season), PLAYINS, FIRST_ROUND, SECOND_ROUND, ROUND_OF_16 (Achtelfinale), ROUND_OF_8 (Viertelfinale), SEMI_FINALS, FINALS, THIRD_PLACE_GAME, QUALIFICATION, GROUP_STAGE. |
| rank | integer | Table position. |
| streak | character | Current streak: W or L; empty when none. |
| streak_count | integer | Length of the current streak. |
| point_corrections | character | Table-point deductions; [] in every sample. |
| home_victories | integer | Home games: wins. |
| home_losses | integer | Home games: number of losses in the table. |
| home_victory_percentage | double | Home games: win percentage, 0-100. |
| away_victories | integer | Away games: wins. |
| away_losses | integer | Away games: number of losses in the table. |
| away_victory_percentage | double | Away games: win percentage, 0-100. |
| table_points | integer | Table points scored (2 per win), from the API's totalPointsMade; the provider's notes call its 'Points' fields table points. |
| table_points_against | integer | Table points conceded (2 per loss), from the API's totalPointsAgainst; per the provider's notes, table points. |
| total_victory_percentage | double | All games: win percentage, 0-100. |
| total_games | integer | Games played in the table (home and away together). |
| total_victories | integer | All games: wins. |
| total_losses | integer | Losses in the table over all games. |
| last10_victories | integer | Wins in the last 10 games. |
| last10_losses | integer | Losses in the last 10 games. |
| last10_percentage | double | Win percentage over the last 10 games, 0-100. |
| last10_outcomes | character | Results of the last games, newest first: W or L. |
| home_last10_victories | integer | Home games: last 10 games, wins. |
| home_last10_losses | integer | Home games: last 10 games, losses. |
| home_last10_victory_percentage | double | Home games: last 10 games, win percentage, 0-100. |
| home_streak | character | Home games: current streak, W or L. |
| home_streak_count | integer | Home games: length of the current streak. |
| away_last10_victories | integer | Away games: last 10 games, wins. |
| away_last10_losses | integer | Away games: last 10 games, losses. |
| away_last10_victory_percentage | double | Away games: last 10 games, win percentage, 0-100. |
| away_streak | character | Away games: current streak, W or L. |
| away_streak_count | integer | Away games: length of the current streak. |
| updated_date | character | Last update of the row, ISO 8601 UTC. |
| ranking_comparison_info | character | Tie-break detail among teams level on record. |
| home_points_for | integer | Home games: basketball points scored (the API's football-style GoalsMade). |
| away_points_for | integer | Away games: basketball points scored (the API's football-style GoalsMade). |
| total_points_for | integer | All games: basketball points scored (the API's football-style GoalsMade). |
| home_points_against | integer | Home games: basketball points allowed (the API's football-style GoalsAgainst). |
| away_points_against | integer | Away games: basketball points allowed (the API's football-style GoalsAgainst). |
| total_points_against | integer | All games: basketball points allowed (the API's football-style GoalsAgainst). |
| home_point_difference | integer | Home games: point differential, scored minus allowed (the API's GoalDifference). |
| away_point_difference | integer | Away games: point differential, scored minus allowed (the API's GoalDifference). |
| total_point_difference | integer | All games: point differential, scored minus allowed (the API's GoalDifference). |
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-keyand anx-api-secretthat 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 withwehoop_asset_fetch.Id key spaces: seasonId is the START year (2025 = 2025-26), so a wrapper's END-year
seasonis sent asseason - 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) andwehoop_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 inheritingwehoop_error. Wrappers raise; they never return an empty frame.
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_playoff_series(),
scb_records_per_game(),
scb_records_season_averages(),
scb_referees(),
scb_season_player(),
scb_season_players(),
scb_season_teams(),
scb_seasons(),
scb_team(),
scb_team_rosters(),
scb_team_seasons(),
scb_team_statistics(),
scb_transfers(),
scb_transfers_teams()
Examples
# \donttest{
try(scb_standings())
#> Error in scb_standings() :
#> www.easycredit-bbl.de/ answered HTTP 503: the API key could not be read.
# }