Game header of a final game: teams, final score, overtimes, venue, attendance, officials and coaches.
Endpoint: GET https://api.kbl.or.kr/match/{gmkey}
Value
A hoopR_data tibble: Game header of a final game: teams, final score, overtimes, venue, attendance, officials and
coaches. The columns are always these, in this order (sportsdataverse-py kbl_game); an empty valid answer raises
hoopR_no_data, a valid body with no rows for this frame is a zero-row tibble:
| col_name | type | description |
| gmkey | character | Game key S{seasonCode}G{gameCode}N{gameNo} (e.g. S47G01N49): the id of every /match/{gmkey} route. |
| glkey | character | Competition key S{seasonCode}G{gameCode} (e.g. S47G01 = 2025-26 regular season): the id of the /leagues and /league/rank routes. |
| season | integer | Season END year (2026 = 2025-26), derived from season_code through the crosswalk (kbl_codes.SEASONS). |
| season_code | integer | KBL season code: sequential over every season and D-League edition (2 = 1997-98, 47 = 2025-26); the crosswalk to the sdv END year is in the README. |
| season_name | character | Season label: 'YYYY-YYYY' for a KBL season (e.g. '2025-2026'), '1997' for the 1997 inaugural season, or the D-League edition name (e.g. '2010KBLWINTER'). |
| season_grade | integer | Division: 1 = the KBL itself, 2 = the KBL D-League (reserve league). |
| game_code | character | Competition type within the season (2-digit string; code table in the README and below): 01 regular season, 03 playoffs, 04 final, ... |
| game_no | integer | Game number within the competition (glkey); the N part of the gmkey. |
| season_category_name | character | Category name in Korean (regular season, playoffs, championship final, D-League stage 1 / 2, All-Star Game, cups, 'KBL' Cup, 'EASL', 'OPEN MATCH DAY'). |
| game_date | Date | Game date (KST). |
| week_day | character | Day of the week in Korean (one Hangul syllable, Monday to Sunday). |
| game_start | character | Tip-off time, HHMM (KST). |
| game_end | character | End time, HHMM (KST); '0000' or blanks when not recorded. |
| game_time | integer | Duration of the game in minutes. |
| home_team_code | character | Home team code. KBL 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). |
| away_team_code | character | Away team code. KBL 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). |
| home_team_name | character | Home team short name (Korean, e.g. Goyang Sono). English names: /common/teamList teamNameEn / teamNameFullEn, joined on the team code. |
| away_team_name | character | Away team short name (Korean, e.g. Changwon LG). English names: /common/teamList teamNameEn / teamNameFullEn, joined on the team code. |
| home_team_name_full | character | Home team full name (Korean). |
| away_team_name_full | character | Away team full name (Korean). |
| home_score | integer | Home team final points, summed from the period scores (the header carries no totals). |
| away_score | integer | Away team final points, summed from the period scores (the header carries no totals). |
| overtimes | integer | Number of overtime periods played (0 for a game decided in regulation). |
| is_started | integer | 1 when the game has started. Unreliable for old games (0 on finished 1997-2006 games in /match/list). |
| is_ended | integer | 1 when the game is over. Unreliable: 0 on every finished game through 2005-06 and on some later ones (e.g. S45G01N95's header); the capture treats a past-dated game with scores as final. |
| playing_quarter | character | Period in progress: 'X' when none (before or after the game), else e.g. 'Q4' or 'EQ1'. Can stay stale after the game (the overtime sample says 'EQ1'). |
| stadium_name | character | Venue short name (Korean). |
| stadium_name_full | character | Venue full name (Korean). |
| stadium_name_en | character | Venue name in English; an empty string, or the Korean name, for some old venues. |
| crowds | integer | Attendance of the game (spectators). |
| tv | character | Broadcaster name(s), e.g. 'tvN SPORTS', 'SPOTV2 / SPOTV ON'. |
| tv_code | character | Broadcaster code(s), comma-separated (e.g. 'T24,T25'); the site uses it instead of tv from seasonCode 45. |
| detail_url | character | Path of the game page on www.kbl.or.kr. |
| highlight_url | character | URL of the game's page on Naver Sports. |
| referee_main | character | Crew chief's name (officials appear by name only). |
| referees_sub | character | JSON list of the umpires' names (officials appear by name only). |
| home_manager | character | Home head coach's name (officials and coaches appear by name only). |
| away_manager | character | Away head coach's name (officials and coaches appear by name only). |
| home_coaches | character | JSON list of the home assistant coaches' names (staff appear by name only). |
| away_coaches | character | JSON list of the away assistant coaches' names (staff appear by name only). |
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in kbl_seasons().
See also
Other KBL Functions:
kbl_current_standings(),
kbl_game_leaders(),
kbl_pbp(),
kbl_period_scores(),
kbl_player_box(),
kbl_player_totals(),
kbl_players(),
kbl_playoff_games(),
kbl_playoff_seeds(),
kbl_playoff_series(),
kbl_round_mvps(),
kbl_rounds(),
kbl_schedule(),
kbl_score_track(),
kbl_season_leaders(),
kbl_seasons(),
kbl_shots(),
kbl_standings(),
kbl_team_box(),
kbl_team_tracks(),
kbl_teams()
Examples
# \donttest{
try(kbl_game(gmkey = "S47G01N49"))
#> ── KBL Game Header from api.kbl.or.kr ─────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:30:54 UTC
#> # A tibble: 1 × 40
#> 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
#> # ℹ 32 more variables: 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>, overtimes <int>, is_started <int>,
#> # is_ended <int>, playing_quarter <chr>, stadium_name <chr>,
#> # stadium_name_full <chr>, stadium_name_en <chr>, crowds <int>, tv <chr>, …
# }