Skip to contents

The phases of a competition (regular season, play-offs, finals) with dates and type.

Endpoint: GET https://api.kzs.si/api/v1/public/competitions/{competition_id}

Usage

kzs_phases(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: The phases of a competition (regular season, play-offs, finals) with dates and type. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py kzs_phases):

col_nametypedescription
competition_idintegerCompetition id: one per competition per season (men's first league 2025/26 = 579, 2026/27 = 608).
seasonintegerSeason END year (2026/2027 = 2027), from the row's own season name or id, else from the request.
phase_idintegerCompetition-phase id. Joins to competitions[].competitionPhaseId on matches and /competitions/{competitionId} phases[].id.
namecharacterPhase name, Slovenian: 'Redni del' = regular season, 'Cetrtfinale' = quarterfinal, 'Polfinale' = semifinal, 'Finale' = final, '1. del' / '2. del' = first / second stage.
start_datecharacterPhase start date (UTC midnight).
end_datecharacterPhase end date (UTC midnight).
typecharacterPhase format (code table).
groupscharacterGroups of the phase (empty when the phase has one table).
wins_neededintegerWins needed to take a best-of series.

Details

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

 kzs_phases(competition_id = 579)