Skip to contents

Teams entered in a competition.

Endpoint: GET https://api.kzs.si/api/v1/public/teams/

Usage

kzs_teams(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: Teams entered in a competition. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py kzs_teams):

col_nametypedescription
competition_idintegerCompetition id: one per competition per season (men's first league 2025/26 = 579, 2026/27 = 608).
team_idintegerTeam-application id: the team's registration (entry) for the season; play-by-play teamApplicationId is the same key space.
team_application_idintegerTeam-application id: the team's registration (entry) for the season; play-by-play teamApplicationId is the same key space.
club_idintegerClub id: the club across seasons and categories (Ilirija = 16). No captured route is keyed by it.
club_memberlogicalTrue when the club is a KZS member (false on nested copies that omit it).
team_internal_rankingcharacterThe club's internal team letter for the category (A = first team, B = second team).
categorycharacterAge category: ABSOLUTE (senior) or U8-U23 / ANY (code table in kzs-returns.md).
rankcharacterTier: FIRST-FOURTH or TOURNAMENT (code table).
gendercharacterMALE or FEMALE.
sport_hall_idintegerSport hall (venue) id. /sportHalls/{id} is in the site bundle, not captured.
sport_hall_namecharacterName of the venue (sports hall) where the game is played or the team is based.
namecharacterTeam name for the season (sponsor name included).
codecharacterTeam 3-letter code.
home_jersey_colorcharacterHome jersey colour, hex '#RRGGBB'.
guest_jersey_colorcharacterAway jersey colour, hex.
logo_uuidcharacterTeam logo: image file id, served at https://api.kzs.si/public/images/{uuid}.
home_team_colorcharacterHome colour, hex.
guest_team_colorcharacterAway colour, hex.
short_namecharacterTeam short name (” when none).

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_teams(competition_id = 579))
#> ── KZS Teams from api.kzs.si ──────────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:28 UTC
#> # A tibble: 11 × 19
#>    competition_id team_id team_application_id club_id club_member
#>             <int>   <int>               <int>   <int> <lgl>      
#>  1            579   17548               45427     254 FALSE      
#>  2            579   17549               45359      55 FALSE      
#>  3            579   17550               45131      46 FALSE      
#>  4            579   17551               45242      16 FALSE      
#>  5            579   17552               45065      26 FALSE      
#>  6            579   17553               45218      49 FALSE      
#>  7            579   17554               45208      56 FALSE      
#>  8            579   17555               45018      45 FALSE      
#>  9            579   17556               45647      44 FALSE      
#> 10            579   17557               45625      59 FALSE      
#> 11            579   17558               45576       9 FALSE      
#> # ℹ 14 more variables: team_internal_ranking <chr>, category <chr>, rank <chr>,
#> #   gender <chr>, sport_hall_id <int>, sport_hall_name <chr>, name <chr>,
#> #   code <chr>, home_jersey_color <chr>, guest_jersey_color <chr>,
#> #   logo_uuid <chr>, home_team_color <chr>, guest_team_color <chr>,
#> #   short_name <chr>
# }