Every game (all competitions, KBL and D-League) of a season or of a date window, with scores and venue.
Endpoint: GET https://api.kbl.or.kr/match/list
Arguments
- season
Season END year (2026 = 2025-26): the window from the first to the last game of that END year's KBL and D-League editions, fetched as at most two requests (one per calendar year). Pass this or from_date and to_date.
- from_date
First date of a window, YYYYMMDD (KST). Needs to_date; inside one calendar year the API answers the whole window in one request (up to 396 games a year, no paging).
- to_date
Last date of the window, YYYYMMDD (KST), not before from_date.
Value
A hoopR_data tibble with one row per game.
Its columns are listed in return_columns
(subset(return_columns, fn == "kbl_schedule")) and in the searchable
return columns article.
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in kbl_seasons().
See also
family_kbl lists every function in this family.
Examples
# \donttest{
try(kbl_schedule(from_date = "20251101", to_date = "20251102"))
#> ── KBL Schedule from api.kbl.or.kr ────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:14:11 UTC
#> # A tibble: 6 × 33
#> gmkey glkey season season_code season_name season_grade game_code game_no
#> <chr> <chr> <int> <int> <chr> <int> <chr> <int>
#> 1 S47G01N49 S47G01 2026 47 2025-2026 1 01 49
#> 2 S47G01N50 S47G01 2026 47 2025-2026 1 01 50
#> 3 S47G01N51 S47G01 2026 47 2025-2026 1 01 51
#> 4 S47G01N52 S47G01 2026 47 2025-2026 1 01 52
#> 5 S47G01N53 S47G01 2026 47 2025-2026 1 01 53
#> 6 S47G01N54 S47G01 2026 47 2025-2026 1 01 54
#> # ℹ 25 more variables: season_category <chr>, season_category_name <chr>,
#> # game_date <date>, week_day <chr>, game_start <chr>, game_end <chr>,
#> # game_time <int>, home_team_code <chr>, away_team_code <chr>,
#> # home_team_name <chr>, away_team_name <chr>, home_team_name_full <chr>,
#> # away_team_name_full <chr>, home_score <int>, away_score <int>,
#> # is_started <int>, is_ended <int>, playing_quarter <chr>,
#> # stadium_name <chr>, stadium_name_full <chr>, stadium_name_en <chr>, …
# }
