Skip to contents

Standings of a competition, one row per team in each phase (and group).

Endpoint: GET https://api.kzs.si/api/v1/public/matches/standings

Usage

kzs_standings(competition_id)

Arguments

competition_id

(required) Competition id (competition_id in kzs_competitions): one per competition per season, e.g. 579 (men's first league 2025/26).

Value

A hoopR_data tibble: Standings of a competition, one row per team in each phase (and group). An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py kzs_standings):

col_nametypedescription
competition_idintegerCompetition id: one per competition per season (men's first league 2025/26 = 579, 2026/27 = 608).
phase_idintegerCompetition-phase id. Joins to competitions[].competitionPhaseId on matches and /competitions/{competitionId} phases[].id.
phase_namecharacterPhase name, Slovenian (see phases[].name).
phase_typecharacterPhase format (code table).
group_idintegerGroup id inside the phase (null when the table is the phase's own).
group_namecharacterGroup name inside the phase (null when the table is the phase's own).
positioninteger1-based position of the row in its table, in the order the API lists it (the wire has no rank column).
team_idintegerTeam id: one club team in one season (Ilirija 2025-26 = 17551). Joins to /teams/{teamId}, standings teamId, box-score teamId and the teamId query params.
team_namecharacterTeam name for the season, sponsor included.
club_codecharacterClub 3-letter code.
logo_uuidcharacterTeam logo: image file id, served at https://api.kzs.si/public/images/{uuid}.
games_playedintegerGames played in the phase.
wonintegerWins in the phase.
lostintegerLosses in the phase.
pts_plusintegerPoints scored by the team through its games played.
pts_minusintegerPoints allowed.
home_wonintegerHome games the team has won.
home_lostintegerHome games the team has lost.
away_wonintegerAway games the team has won.
away_lostintegerAway games the team has lost.
pointsintegerTable points: 2 per win, 1 per loss (Krka 26-1 = 53).
drawsintegerDraws (0: basketball has none).
lost_pointsintegerTable points deducted (0 in every sample).
tie_break_positionintegerFinal position after tie-breaks (absent on playoff-phase rows).
pts_differenceintegerPoint differential (scored - allowed).

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_standings(competition_id = 579))
#> ── KZS Standings from api.kzs.si ──────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:25 UTC
#> # A tibble: 24 × 25
#>    competition_id phase_id phase_name phase_type group_id group_name position
#>             <int>    <int> <chr>      <chr>         <int> <chr>         <int>
#>  1            579     5811 Redni del  GROUP            NA NA                1
#>  2            579     5811 Redni del  GROUP            NA NA                2
#>  3            579     5811 Redni del  GROUP            NA NA                3
#>  4            579     5811 Redni del  GROUP            NA NA                4
#>  5            579     5811 Redni del  GROUP            NA NA                5
#>  6            579     5811 Redni del  GROUP            NA NA                6
#>  7            579     5811 Redni del  GROUP            NA NA                7
#>  8            579     5811 Redni del  GROUP            NA NA                8
#>  9            579     5811 Redni del  GROUP            NA NA                9
#> 10            579     5811 Redni del  GROUP            NA NA               10
#> # ℹ 14 more rows
#> # ℹ 18 more variables: team_id <int>, team_name <chr>, club_code <chr>,
#> #   logo_uuid <chr>, games_played <int>, won <int>, lost <int>, pts_plus <int>,
#> #   pts_minus <int>, home_won <int>, home_lost <int>, away_won <int>,
#> #   away_lost <int>, points <int>, draws <int>, lost_points <int>,
#> #   tie_break_position <int>, pts_difference <int>
# }