Skip to contents

Team box score of a final game with advanced rates and team-only counts, one row per team.

Endpoint: GET https://api.kbl.or.kr/match/{gmkey}/team-record

Usage

kbl_team_box(gmkey)

Arguments

gmkey

Game key S{seasonCode}G{gameCode}N{gameNo}, e.g. 'S47G01N49' (the 2025-26 regular season's game 49): season_code, game_code and game_no of kbl_schedule. Only final games are served; a malformed key is a hoopR_bad_request.

Value

A hoopR_data tibble: Team box score of a final game with advanced rates and team-only counts, one row per team. The columns are always these, in this order (sportsdataverse-py kbl_team_box); an empty valid answer raises hoopR_no_data, a valid body with no rows for this frame is a zero-row tibble:

col_nametypedescription
gmkeycharacterGame key S{seasonCode}G{gameCode}N{gameNo} (e.g. S47G01N49): the id of every game route and game frame.
season_codeintegerKBL season code: one sequential number over every season and D-League edition (47 = 2025-26, 48 = the 2025 D-League).
seasonintegerSeason END year (2026 = 2025-26), derived from season_code through the crosswalk (kbl_codes.SEASONS).
game_codecharacterCompetition inside the season, two digits: 01 regular season, 03 playoffs, 04 final, 07 EASL, 08 D-League stage 2, 10 All-Star, 11/13 cups, 14 Open Match Day.
game_nointegerGame number inside the competition (glkey): the N part of the gmkey.
team_codecharacterKBL team code (2-digit string, e.g. '50' = Changwon LG). Joins to /common/teamList teamCode, game tcodeH/tcodeA, t in text-cast. Not stable across ownership changes: the Anyang club is '40' (SBS) in 1997-98 and '70' today. D-League sides have their own codes (teamCodeD).
scoreintegerPoints. This game, team total.
fgintegerTwo-point field goals made, dunks included: 201 + 207 rows (score = 2fg + 3threep + ft holds on every sampled box). This game, team total.
fg_aintegerTwo-point field-goal attempts, made + missed, dunks included: 201 + 202 + 207 + 208 rows (checked per team on S47G01N49). This game, team total.
fgtintegerField goals made, two- and three-point (fg + threep). This game, team total.
fgt_aintegerField-goal attempts, two- and three-point (fgA + threepA). This game, team total.
threepintegerThree-point field goals made (action 205). This game, team total.
threep_aintegerThree-point attempts, made + missed (205 + 206). This game, team total.
ftintegerFree throws made (action 203). This game, team total.
ft_aintegerFree-throw attempts, made + missed (203 + 204). This game, team total.
dkintegerDunks made (action 207); included in fg. This game, team total.
dk_aintegerDunk attempts (made + missed, actions 207 + 208). This game, team total.
rbintegerTotal rebounds (offr + defr; team rebounds are teamR). This game, team total.
offrintegerOffensive rebounds (action 209). This game, team total.
defrintegerDefensive rebounds (action 210). This game, team total.
astintegerAssists (action 211). This game, team total.
stlintegerSteals (action 212). This game, team total.
bsintegerBlocked shots (action 213). This game, team total.
tointegerTurnovers (action 214). This game, team total.
foulintegerPersonal fouls (wft + woft). This game, team total.
wftintegerFouls that awarded free throws (action 215). This game, team total.
woftintegerFouls that awarded no free throws (action 216). This game, team total.
ppintegerField goals made in the paint. This game, team total.
pp_aintegerField-goal attempts in the paint. This game, team total.
pscoreintegerPoints in the paint (2 * pp). This game, team total.
sastintegerScreen assists (action 226; tracked in recent seasons only, 0 before). This game, team total.
dflintegerDeflections (action 227; tracked in recent seasons only, 0 before). This game, team total.
gdintegerGood-defense plays (action 221). This game, team total.
idfintegerIllegal-defense violations (action 219; an early-KBL rule, so non-zero only in old seasons). This game, team total.
fbintegerFast breaks credited to the player (action 217 rows that name a player, as in 1997-98); 0 in recent seasons, where fast breaks are team rows (tfb). This game, team total.
efintegerMeaning unverified (0 in every game sample; non-zero in some season totals). This game, team total.
tfintegerProbably technical fouls (unverified; 0 in most rows). This game, team total.
inoutintegerTimes the player entered the game, the start included (checked on the 2025-26 sample game); a team row sums its players. This game, team total.
inout1integerTimes the player was substituted out before the end (checked on the 2025-26 sample game); a team row sums its players. This game, team total.
play_minintegerMinutes of playing time summed over the players (200 = 5 x 40 in regulation); add playSec. This game, team total.
play_secintegerSeconds part of the playing time (0-59), added to playMin. This game, team total.
bfintegerMeaning unverified (probably bench fouls; 0 in every game sample). This game, team total.
fouloutintegerPlayers fouled out (unverified). This game, team total.
team_rintegerTeam rebounds (action 218). This game, team total.
tfbintegerTeam fast breaks (action 217). This game, team total.
ttointegerTeam turnovers (action 223). This game, team total.
fb_score_cnintegerFast-break points. This game, team total.
turnover_score_cnintegerPoints off turnovers. This game, team total.
sec_chance_score_cnintegerSecond-chance points. This game, team total.
bench_score_cnintegerBench points. This game, team total.
max_conti_score_cnintegerLongest scoring run: the most consecutive points without an opponent score. This game, team total.
max_lead_score_cnintegerLargest lead, in points. This game, team total.
score_high_time_cnintegerSeconds the team led (the two teams' values sum to less than the 2,400-second game when it was tied or level at times). This game, team total.
offrtgdoubleOffensive rating: points scored per 100 possessions (estimated). This game, team total.
defrtgdoubleDefensive rating: points allowed per 100 possessions (estimated). This game, team total.
netrtgdoubleNet rating: offrtg - defrtg. This game, team total.
efg_rtdoubleEffective field-goal percentage, 0-100. This game, team total.
ts_rtdoubleTrue-shooting percentage, 0-100. This game, team total.
ast_rtdoubleAssist rate: share of teammates' field goals assisted while on court, 0-100. This game, team total.
ast_todoubleAssist-to-turnover ratio. This game, team total.
ast_ratiodoubleAssist ratio: assists per 100 possessions used. This game, team total.
oreb_rtdoubleOffensive-rebound percentage, 0-100. This game, team total.
dreb_rtdoubleDefensive-rebound percentage, 0-100. This game, team total.
reb_rtdoubleTotal-rebound percentage, 0-100. This game, team total.
pacedoublePossessions per 40 minutes (estimated; a player row covers his minutes on court). This game, team total.
tov_rtdoubleTurnover rate: turnovers per 100 possessions, 0-100. This game, team total.
possdoublePossessions (estimated). This game, team total.
minutes_playeddoublePlaying time in minutes (play_min + play_sec / 60), derived.

Details

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

Examples

# \donttest{
  try(kbl_team_box(gmkey = "S47G01N49"))
#> ── KBL Team Box Score from api.kbl.or.kr ──────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:06 UTC
#> # A tibble: 2 × 68
#>   gmkey   season_code season game_code game_no team_code score    fg  fg_a   fgt
#>   <chr>         <int>  <int> <chr>       <int> <chr>     <int> <int> <int> <int>
#> 1 S47G01…          47   2026 01             49 50           64    14    35    25
#> 2 S47G01…          47   2026 01             49 66           74    23    43    30
#> # ℹ 58 more variables: fgt_a <int>, threep <int>, threep_a <int>, ft <int>,
#> #   ft_a <int>, dk <int>, dk_a <int>, rb <int>, offr <int>, defr <int>,
#> #   ast <int>, stl <int>, bs <int>, to <int>, foul <int>, wft <int>,
#> #   woft <int>, pp <int>, pp_a <int>, pscore <int>, sast <int>, dfl <int>,
#> #   gd <int>, idf <int>, fb <int>, ef <int>, tf <int>, inout <int>,
#> #   inout1 <int>, play_min <int>, play_sec <int>, bf <int>, foulout <int>,
#> #   team_r <int>, tfb <int>, tto <int>, fb_score_cn <int>, …
# }