Skip to contents

Games of one round of a championship: teams, score, venue, referees and broadcasters.

Endpoint: GET https://www.legabasket.it/api/championships/get-championships-calendar-by-id (id=<championship_id>&d=<round>)

Usage

lba_calendar(championship_id, round = NULL)

Arguments

championship_id

(required) Championship id (championship_id in lba_championships): one season AND one phase.

round

Round number (day_serial, 1, 2, ...). Omitted = the current round (the last played for a finished championship).

Value

A hoopR_data tibble: Games of one round of a championship: teams, score, venue, referees and broadcasters. The columns are always these, in this order (sportsdataverse-py lba_calendar); a column the site adds later is appended after them:

col_nametypedescription
seasonintegerSeason END year (2027 = 2026-27): the row's START year + 1.
game_idintegerGame id (global across seasons); joins lba_calendar and lba_game.
game_statuscharacterGame status, number sent as a string: 0 scheduled, 1 live, 2 final (per the OSS client; only 2 sampled).
championship_idintegerChampionship id (season + phase) of the game.
championships_day_idintegerRound id (championships_day_id key space: one round of one championship; joins filters.days[].id and standings championships_day_id; not the d param).
yearintegerSeason START year (2026 = 2026-27); sdv END year = year + 1.
numberintegerRound number of the game, equal to day_serial (the d echo the capture checks).
match_datetimecharacterTip-off, ISO-8601 with the Italian offset (1995-96: midnight, no time kept).
match_hhintegerTip-off hour, local time.
match_mmintegerTip-off minute, local time.
home_final_scoreintegerFinal points of the home team.
visitor_final_scoreintegerFinal points of the away team.
target_scorecharacterNull in every sample (meaning unverified).
additional_timeintegerOvertime periods played (0 in every sample; reading inferred).
plant_idintegerArena id (arena key space; joins nothing specced).
websocket_match_idintegerLive-feed game id, number sent as a string; separate from the game id.
ticketing_urlcharacterTicket shop URL (null for old games).
has_streaminginteger1 when a stream exists, else 0.
updated_atcharacterTimestamp, ISO-8601 with the Italian offset. Last update of the game row.
h_team_idintegerHome team id (team-season).
h_team_namecharacterHome team name (sponsor name of that season).
h_club_codecharacterHome club code, e.g. TVB; null on the 2017-18 and 1995-96 calendar rows.
h_team_enabledlogicalHome team page enabled on the site.
home_logo_keycharacterImage key: the image is {cdn_url}/{key}, resized copies {cdn_url}/variants/{key}/thumb or /large (the site's getApiImageUrl).
v_team_idintegerAway team id (team-season).
v_team_namecharacterVisitor team name (the sponsor name of that season).
v_club_codecharacterAway club code (BCR); null on the 2017-18 and 1995-96 calendar rows.
v_team_enabledlogicalAway team page enabled on the site.
v_logo_keycharacterImage key: the image is {cdn_url}/{key}, resized copies {cdn_url}/variants/{key}/thumb or /large (the site's getApiImageUrl).
town_idintegerTown id of the arena (town key space; joins nothing specced).
plant_namecharacterName of the arena where the game is played.
town_namecharacterTown of the arena.
day_codecharacterRound code (1, 2, ...; string in game rows, integer in standings).
day_serialintegerRound number (event_serial, the d param).
day_namecharacterRound name, Italian: 1o Giornata = matchday 1.
match_serie_keycharacterThe two team ids joined low_high (1761_1764).
refereescharacterJSON list of the game's referees (id, name, surname); null when the site lists none.
broadcasterscharacterJSON list of the game's broadcasters (name, logo key); null when the site lists none.

Details

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

Examples

# \donttest{
  try(lba_calendar(championship_id = 602, round = 1))
#> ── LBA Calendar from legabasket.it ────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:31 UTC
#> # A tibble: 8 × 38
#>   season game_id game_status championship_id championships_day_id  year number
#>    <int>   <int> <chr>                 <int>                <int> <int>  <int>
#> 1   2027   25602 2                       602                 4486  2026      1
#> 2   2027   25603 2                       602                 4486  2026      1
#> 3   2027   25605 2                       602                 4486  2026      1
#> 4   2027   25600 2                       602                 4486  2026      1
#> 5   2027   25601 2                       602                 4486  2026      1
#> 6   2027   25607 2                       602                 4486  2026      1
#> 7   2027   25604 2                       602                 4486  2026      1
#> 8   2027   25606 2                       602                 4486  2026      1
#> # ℹ 31 more variables: match_datetime <chr>, match_hh <int>, match_mm <int>,
#> #   home_final_score <int>, visitor_final_score <int>, target_score <chr>,
#> #   additional_time <int>, plant_id <int>, websocket_match_id <int>,
#> #   ticketing_url <chr>, has_streaming <int>, updated_at <chr>,
#> #   h_team_id <int>, h_team_name <chr>, h_club_code <chr>,
#> #   h_team_enabled <lgl>, home_logo_key <chr>, v_team_id <int>,
#> #   v_team_name <chr>, v_club_code <chr>, v_team_enabled <lgl>, …
# }