Skip to contents

Team totals of a final game's box score, one row per side.

Endpoint: GET https://api.kzs.si/api/v1/public/matches/{match_id}/stats

Usage

kzs_team_box_score(match_id)

Arguments

match_id

(required) Match id (match_id in kzs_matches), e.g. 101839. Global across seasons.

Value

A hoopR_data tibble: Team totals of a final game's box score, one row per side. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py kzs_team_box_score):

col_nametypedescription
match_idintegerMatch id: the federation key of a game, global across seasons (joins kzs_matches and kzs_match).
team_sidecharacterWhich side of the match the row belongs to: home (the organiser, firstTeam on the wire) or away.
team_idintegerTeam id: one club team in one season (joins kzs_teams); not the match-team id and not the club id.
team_namecharacterName of the team for the season, sponsor included.
minutesdoubleTeam minutes: the sum of its players (200.0 = 5 x 40; 0.0 on 2015-16 team lines).
two_pmintegerThe team's two-point field goals made.
two_paintegerThe team's two-point field goals attempted.
two_p_percdoubleThe team's two-point percentage, 0-100.
three_pmintegerThe team's three-point field goals made.
three_paintegerThe team's three-point field goals attempted.
three_p_percdoubleThe team's three-point percentage, 0-100.
f_tmintegerThe team's free throws made.
f_taintegerThe team's free throws attempted.
f_t_percdoubleThe team's free-throw percentage, 0-100.
fg_mintegerThe team's field goals made.
fg_aintegerThe team's field goals attempted.
fg_percdoubleThe team's field-goal percentage, 0-100.
offensive_reboundsintegerThe team's offensive rebounds.
defensive_reboundsintegerThe team's defensive rebounds.
total_reboundsintegerThe team's total rebounds.
assistsintegerThe team's assists.
stealsintegerThe team's steals.
turnoversintegerThe team's turnovers.
blocks_in_favorintegerThe team's shots blocked (blocks made).
blocks_againstintegerThe team's own shots that were blocked.
foul_commitedintegerThe team's fouls committed.
foul_receivedintegerThe team's fouls drawn.
p_irintegerThe team's PIR, performance index rating ((points + rebounds + assists + steals + blocks + fouls drawn) - (missed field goals + missed free throws + turnovers + shots blocked + fouls committed)).
plus_minusintegerThe team's plus-minus: points scored minus allowed while on court (team line: the final margin).
assists_turnover_ratiodoubleThe team's assist-to-turnover ratio (0 in every sample: not computed).
defensive_ratingdoubleThe team's defensive rating (0 in every sample: not computed).
efficiencyintegerTeam efficiency (PIR); -1 on 2015-16 team lines (not computed).
pointsintegerThe team's points.
efficiency_customdoubleThe team's custom efficiency as the federation computes it (equal to efficiency on player rows; 0 on team lines).
efficiency_game_scoredoubleThe team's game score (0 in every sample: not computed).
fast_break_points_attemptedintegerThe team's fast-break attempts (0 in every sample: not computed).
fast_break_points_madeintegerThe team's fast-break makes (0 in every sample: not computed).
usage_percentagedoubleThe team's usage percentage (0 in every sample: not computed).
m_vp_votesintegerThe team's MVP votes (0 in every sample).
minusintegerThe team's points allowed on court (0 in every sample: not computed).
offensive_ratingdoubleThe team's offensive rating (0 in every sample: not computed).
p_erdoubleThe team's PER (0 in every sample: not computed).
plusintegerThe team's points scored on court (0 in every sample: not computed).
points_fast_breakintegerThe team's fast-break points.
points_in_the_paintintegerThe team's points in the paint.
points_in_the_paint_attemptedintegerThe team's paint attempts (0 in every sample: not computed).
points_in_the_paint_madeintegerThe team's paint makes (0 in every sample: not computed).
points_second_chanceintegerThe team's second-chance points.
second_chance_points_attemptedintegerThe team's second-chance attempts (0 in every sample: not computed).
second_chance_points_madeintegerThe team's second-chance makes (0 in every sample: not computed).
true_shooting_attemptsintegerThe team's true-shooting attempts (0 in every sample: not computed).
true_shooting_percentagedoubleThe team's true-shooting percentage (0 in every sample: not computed).
bench_pointsintegerPoints by players who did not start.
biggest_leadintegerBiggest lead, points.
biggest_scoring_runintegerBiggest unanswered scoring run, points.
fouls_bench_technicalintegerTechnical fouls charged to the bench (not the coach).
fouls_coach_disqualifyingintegerDisqualifying fouls charged to the head coach.
fouls_coach_technicalintegerTechnical fouls charged to the head coach.
fouls_disqualifyingintegerDisqualifying fouls by players (ejections).
fouls_offensiveintegerOffensive (charging) fouls by players.
fouls_onintegerFouls drawn by the team.
fouls_personalintegerPersonal fouls by players, all kinds that count toward fouling out.
fouls_teamintegerTeam fouls (0 in every sample).
fouls_technicalintegerTechnical fouls by players.
fouls_technical_otherintegerOther technical fouls (0 in every sample).
fouls_throw_inintegerThrow-in fouls (0 in every sample).
fouls_totalintegerAll fouls committed.
fouls_unsportsmanlikeintegerUnsportsmanlike (flagrant) fouls by players.
fouled_outintegerPlayers fouled out (0 in every sample).
lead_changesintegerLead changes in the game.
points_from_turnoversintegerPoints off opponent turnovers.
time_leadingdoubleTime the team led, decimal minutes.
times_scores_levelintegerTimes the score was tied.
rebounds_teamintegerTeam rebounds (not credited to a player).
rebounds_team_defensiveintegerDefensive rebounds credited to the team, not a player.
rebounds_team_offensiveintegerOffensive rebounds credited to the team, not a player.
turnovers_teamintegerTeam turnovers (not credited to a player).

Details

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

Examples

# \donttest{
  try(kzs_team_box_score(match_id = 101839))
#> ── KZS Team Box Score from api.kzs.si ─────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:26 UTC
#> # A tibble: 2 × 77
#>   match_id team_side team_id team_name minutes two_pm two_pa two_p_perc three_pm
#>      <int> <chr>       <int> <chr>       <dbl>  <int>  <int>      <dbl>    <int>
#> 1   101839 home        17551 Perspekt…     225     26     43       60.5        7
#> 2   101839 away        17555 Terme Ol…     225     23     45       51.1       12
#> # ℹ 68 more variables: three_pa <int>, three_p_perc <dbl>, f_tm <int>,
#> #   f_ta <int>, f_t_perc <dbl>, fg_m <int>, fg_a <int>, fg_perc <dbl>,
#> #   offensive_rebounds <int>, defensive_rebounds <int>, total_rebounds <int>,
#> #   assists <int>, steals <int>, turnovers <int>, blocks_in_favor <int>,
#> #   blocks_against <int>, foul_commited <int>, foul_received <int>, p_ir <int>,
#> #   plus_minus <int>, assists_turnover_ratio <dbl>, defensive_rating <dbl>,
#> #   efficiency <int>, points <int>, efficiency_custom <dbl>, …
# }