Skip to contents

Team profile: club, home hall, colours and the competitions the team entered.

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

Usage

kzs_team(team_id)

Arguments

team_id

(required) Team id (team_id in kzs_teams): one club team in one season, e.g. 17551. Not the match-team id nor the club id.

Value

A hoopR_data tibble: Team profile: club, home hall, colours and the competitions the team entered. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py kzs_team):

col_nametypedescription
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).
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.
sport_hall_address_idintegerId of the venue's address record.
sport_hall_address_post_office_idintegerPost-office id (FMS internal).
sport_hall_address_post_office_zip_codecharacterPostal code (REDACTED under a club addresses[] row; kept for venues).
sport_hall_address_post_office_namecharacterPost-office town.
sport_hall_address_post_office_municipalitycharacterMunicipality, upper case.
sport_hall_address_post_office_countrycharacterCountry, ISO 3166-1 alpha-2 (SI).
sport_hall_address_streetcharacterVenue street (a public sports hall).
sport_hall_address_house_numbercharacterVenue house number, a string ('6 A').
namecharacterTeam name for the season (sponsor name included).
codecharacterTeam 3-letter code.
season_idintegerSeason id: OPAQUE, not a year (1 = 2000/2001 ... 27 = 2026/2027, 31 = 1991/1992). The season name is 'START/END'; the sdv season is the END year (the second half of name).
season_namecharacterSeason, 'START/END' (2025/2026); sdv season = the END year.
season_is_activelogicalTrue for the current season only (2026/2027 on 2026-10-12).
season_activelogicalSame as isActive.
short_namecharacterTeam short name (” when none).
home_jersey_colorcharacterHome jersey colour, hex '#RRGGBB'.
guest_jersey_colorcharacterAway jersey colour, hex.
logo_uuidcharacterLogo: image file id, served at https://api.kzs.si/public/images/{uuid}.
seasonintegerSeason of the registration.
competitionscharacterCompetitions of the team this season (id, name, rule, phases).

Details

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

 kzs_team(team_id = 17551)