Skip to contents

Standings of one competition with each team's season totals.

Endpoint: GET https://api.kbl.or.kr/league/rank/{season}

Usage

kbl_standings(season, division = "kbl", game_code = "01")

Arguments

season

Season END year (2026 = 2025-26; the inaugural 1997 season is 1997, the latest 2027). kbl_runtime maps it to the KBL seasonCode (47 = 2025-26).

division

'kbl' (the KBL itself, the default) or 'd_league' (the KBL D-League reserve league, seasonGrade 2, which has its own season codes; it starts with the 2009 summer edition).

game_code

Competition inside the season, two digits: '01' regular season (default; the first stage of a D-League edition), '03' playoffs, '04' championship final, '07' EASL, '08' D-League stage 2, '10' All-Star, '11'/'13' cups, '14' Open Match Day. Only '01' was probed live.

Value

A hoopR_data tibble: Standings of one competition with each team's season totals. The columns are always these, in this order (sportsdataverse-py kbl_standings); an empty valid answer raises hoopR_no_data, a valid body with no rows for this frame is a zero-row tibble:

col_nametypedescription
seasonintegerSeason END year (2026 = 2025-26), derived from season_code through the crosswalk (kbl_codes.SEASONS).
season_codeintegerKBL season code: one sequential number over every season and D-League edition (47 = 2025-26, 48 = the 2025 D-League).
game_codecharacterCompetition type within the season (2-digit string; code table in the README and below): 01 regular season, 03 playoffs, 04 final, ...
rankintegerStanding (1 = first).
team_codecharacterTeam code: the KBL club in that season (two-digit string with a leading zero, e.g. '50' = Changwon LG). Joins kbl_teams team_code; not stable across ownership changes (the Anyang club is '40' in 1997-98, '70' today).
team_namecharacterTeam short name (Korean, e.g. Wonju DB). English names: /common/teamList teamNameEn / teamNameFullEn, joined on the team code.
team_name_fullcharacterTeam full name (Korean).
game_countintegerGames played (this season or competition).
winsintegerSeason wins of the team (the wire's TWin).
lossesintegerSeason losses of the team (the wire's TLoss).
drawsintegerDraws (TDraw, always 0).
win_ratedoubleWin fraction, 0-1.
win_diffdoubleGames behind the leader.
home_winsintegerWins in the team's home games.
home_lossesintegerLosses in the team's home games.
away_winsintegerWins in the team's away games.
away_lossesintegerLosses in the team's away games.
conti_winintegerCurrent winning streak (0 when the last game was a loss).
conti_lossintegerCurrent losing streak (0 when the last game was a win).
conti_dateDateDate (YYYYMMDD) the current streak started (inferred; unverified).
max_winintegerLongest winning streak of the season.
max_lossintegerLongest losing streak of the season.
last_game_dateDateDate of the latest game counted in the row, YYYYMMDD.
last_fivecharacterThe last five results as a comma-separated string, most recent first: 1 win, 0 loss (the name is cut short in the API).
last_game_wonlogicalTrue when the team's latest game was a win (the wire's win; a boolean, not a count).
last_game_lostlogicalTrue when the team's latest game was a loss (inferred from conti_loss).
last_game_drawnlogicalTrue when the team's latest game was a draw (always false).
game_flaglogicalBoolean flag in the standings row; meaning unverified (true in the sample).
updated_atcharacterWhen the standings row was written (ISO 8601 UTC timestamp).
scoreintegerPoints. Team season total for the competition (glkey).
fgintegerTwo-point field goals made, dunks included: 201 + 207 rows (score = 2fg + 3threep + ft holds on every sampled box). Team season total for the competition (glkey).
fg_aintegerTwo-point field-goal attempts, made + missed, dunks included: 201 + 202 + 207 + 208 rows (checked per team on S47G01N49). Team season total for the competition (glkey).
threepintegerThree-point field goals made (action 205). Team season total for the competition (glkey).
threep_aintegerThree-point attempts, made + missed (205 + 206). Team season total for the competition (glkey).
ftintegerFree throws made (action 203). Team season total for the competition (glkey).
ft_aintegerFree-throw attempts, made + missed (203 + 204). Team season total for the competition (glkey).
dkintegerDunks made (action 207); included in fg. Team season total for the competition (glkey).
dk_aintegerDunk attempts (made + missed, actions 207 + 208). Team season total for the competition (glkey).
astintegerAssists. Team season total for the competition (glkey).
bsintegerBlocked shots. Team season total for the competition (glkey).
defrintegerDefensive rebounds. Team season total for the competition (glkey).
offrintegerOffensive rebounds. Team season total for the competition (glkey).
stlintegerSteals. Team season total for the competition (glkey).
tointegerTurnovers. Team season total for the competition (glkey).
team_rintegerTeam rebounds (action 218), unverified against teamR. Team season total for the competition (glkey).
ppintegerPaint field goals made: 0 in every sampled row (see PScore).
pp_aintegerPaint field-goal attempts: 0 in every sampled row (see PScore).
pscoreintegerPoints in the paint (pp/ppA are 0 on this route in every sampled row). Team season total for the competition (glkey).
wftintegerFouls that awarded free throws (action 215). Team season total for the competition (glkey).
woftintegerFouls that awarded no free throws (action 216). Team season total for the competition (glkey).
foul_totalintegerPersonal fouls over the season (foulTot).
tfbintegerTeam fast breaks (action 217). Team season total for the competition (glkey).
ttointegerTeam turnovers (action 223). Team season total for the competition (glkey).
tfintegerProbably technical fouls (unverified; 0 in most rows). Team season total for the competition (glkey).
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). Team season total for the competition (glkey).
efintegerMeaning unverified (0 in every game sample; non-zero in some season totals). Team season total for the competition (glkey).
bfintegerMeaning unverified (probably bench fouls; 0 in every game sample). Team season total for the competition (glkey).
gdintegerGood-defense plays (action 221). Team season total for the competition (glkey).
idfintegerIllegal-defense violations (action 219; an early-KBL rule, so non-zero only in old seasons). Team season total for the competition (glkey).
inoutintegerTimes the player entered the game, the start included (checked on the 2025-26 sample game); a team row sums its players. Team season total for the competition (glkey).
inout1integerTimes the player was substituted out before the end (checked on the 2025-26 sample game); a team row sums its players. Team season total for the competition (glkey).
fouloutintegerPlayers fouled out (unverified). Team season total for the competition (glkey).
play_minintegerMinutes of playing time; add playSec seconds. Team season total for the competition (glkey).
play_secintegerSeconds part of the playing time (0-59), added to playMin. Team season total for the competition (glkey).

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_standings(season = 2025))
#> ── KBL Standings from api.kbl.or.kr ───────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:05 UTC
#> # A tibble: 10 × 64
#>    season season_code game_code  rank team_code team_name         team_name_full
#>     <int>       <int> <chr>     <int> <chr>     <chr>             <chr>         
#>  1   2025          45 01            1 55        서울 SK           서울 SK 나이츠
#>  2   2025          45 01            2 50        창원 LG           창원 LG 세이커스……
#>  3   2025          45 01            3 10        울산 현대모비스   울산 현대모비스 피버스……
#>  4   2025          45 01            4 06        수원 KT           수원 KT 소닉붐
#>  5   2025          45 01            5 64        대구 한국가스공사 대구 한국가스공사 페가수…
#>  6   2025          45 01            6 70        안양 정관장       안양 정관장 레드부스터스…
#>  7   2025          45 01            7 16        원주 DB           원주 DB 프로미
#>  8   2025          45 01            8 66        고양 소노         고양 소노 스카이거너스……
#>  9   2025          45 01            9 60        부산 KCC          부산 KCC 이지스……
#> 10   2025          45 01           10 35        서울 삼성         서울 삼성 썬더스……
#> # ℹ 57 more variables: game_count <int>, wins <int>, losses <int>, draws <int>,
#> #   win_rate <dbl>, win_diff <dbl>, home_wins <int>, home_losses <int>,
#> #   away_wins <int>, away_losses <int>, conti_win <int>, conti_loss <int>,
#> #   conti_date <date>, max_win <int>, max_loss <int>, last_game_date <date>,
#> #   last_five <chr>, last_game_won <lgl>, last_game_lost <lgl>,
#> #   last_game_drawn <lgl>, game_flag <lgl>, updated_at <chr>, score <int>,
#> #   fg <int>, fg_a <int>, threep <int>, threep_a <int>, ft <int>, ft_a <int>, …
# }