Skip to contents

Single-game records: the season's and the all-time ones, one row per record.

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

Usage

scb_records_per_game(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: Single-game records: the season's and the all-time ones, one row per record. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py scb_records_per_game):

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.
scopecharacterseason for the requested season's records, all_time for the all-time list.
statcharacterThe record's stat: points, rebounds, assists, steals, blocks, turnovers, efficiency, free_throws_made, three_point_shots_made or free_throws_success_percentage.
placeintegerRank within the list (1 = best); 0 on some rows.
all_time_placeintegerRank on the all-time list; null when not on it.
order_idintegerSort order within the list.
all_time_order_idintegerSort order on the all-time list; null when not on it.
valuedoubleThe record value. A STRING in /records/per-game ('52'); a number in /records/season-averages.
ratiodouble[made, attempted] as strings, on percentage records only; null otherwise.
season_player_idcharacterSeason-player id: one player's engagement with one club (kept across seasons while he stays, new after a move; see README). Joins to box-score seasonPlayer.id, action seasonPlayerId and /season-players/{seasonPlayerId}.
real_player_idintegerGlobal person id: the same across clubs and seasons. Joins to realPlayerId everywhere.
first_namecharacterPlayer's given name.
last_namecharacterPlayer's family name.
team_namecharacterTeam name as listed that season (sponsor names included).
team_tlccharacterThe player's team code.
home_tlccharacterThree-letter code of the home team of the record game.
guest_tlccharacterThree-letter code of the guest team of the record game.
game_idcharacterGame id, a string. Joins to /games/{gameId}.
scheduled_timecharacterScheduled tip-off, ISO 8601 UTC.

Details

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

 scb_records_per_game(season = 2026)