Every round of a season with its games: one call lists every game id.
One row per game with its round (round_id, round_number) and the teams looked up in the body's team
list. The cheapest way to crawl a season: one call lists every game id.
Endpoint: GET https://api2.acb.com/api/seasondata/Calendar/season-calendar
Arguments
- competition_id
(default
NULL) Competition id: 1 Liga Endesa, 2 Copa del Rey, 3 Supercopa Endesa, 10 Minicopa Endesa (youth). Omitted = the API's default competition. A whole number; a whole double is accepted.- season
(default
NULL) Season END year (2027 = 2026-27; the first ACB season, 1983-84, is 1984).acb_runtimesends the API'seditionId= season - 1936. Omitted = the current season. A whole number; a whole double is accepted.
Value
A hoopR_data tibble, one row per record described above; the columns are always these, in this order
(sportsdataverse-py acb_calendar):
| col_name | type | description |
| competition_id | integer | Competition id: 1 Liga Endesa, 2 Copa del Rey, 3 Supercopa Endesa, 10 Minicopa Endesa. |
| edition_id | integer | Season id (editionId) = season START year - 1935 (91 = 2026-27). The wrappers take the END year, season. |
| season | integer | Season END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take. |
| round_id | integer | Global round id (6017 = Liga 2026-27 round 3); not the round number. |
| round_number | integer | Round number within its phase. |
| subphase_id | integer | Sub-phase id of the round (playoff stages); null in the regular season. |
| subphase_number | integer | Sub-phase number of the round; null in the regular season. |
| week_id | integer | Not sent by the calendar route (always null). |
| match_id | integer | Match id. Legacy ids (seasons up to 2019-20) sit below about 20000 (12559 = 2005-06 final, 17718 = 2016-17 final); from 2020-21 they start at about 100000 (102920 in 2021-22, 105401 in 2026-27). One key space across competitions: the matchId param of every matchdata route. |
| home_team_id | integer | Home season-team entry id (new every season; joins the body's team list). |
| away_team_id | integer | Away season-team entry id (new every season; joins the body's team list). |
| home_score | integer | Home points (null before the match) |
| away_score | integer | Away points (null before the match) |
| start | POSIXct | Tip-off, ISO 8601 UTC |
| status | character | Match state (x-match-statuses) |
| is_on_half_time | logical | At half time (live) |
| current_quarter | integer | Current or last quarter (5+ = overtime); not reliable after the match (1 in the 2017 series rows) |
| home_club_id | integer | Stable club id of the home team (looked up in the body's team list). |
| home_team | character | Home team name for the season (looked up in the body's team list). |
| home_team_abbr | character | Home team three-letter abbreviation (looked up in the body's team list). |
| away_club_id | integer | Stable club id of the away team (looked up in the body's team list). |
| away_team | character | Away team name for the season (looked up in the body's team list). |
| away_team_abbr | character | Away team three-letter abbreviation (looked up in the body's team list). |
| ticketing_link | character | Ticket shop URL; null when none. |
| broadcasters | character | Broadcast channel names of the game joined with '; ' (the first is the primary). |
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in acb_match_header().
See also
Other ACB Functions:
acb_box_info(),
acb_bracket(),
acb_bracket_games(),
acb_career_stints(),
acb_career_trophies(),
acb_club_data(),
acb_competition_current(),
acb_competition_editions(),
acb_competition_rounds(),
acb_competition_weeks(),
acb_current_roster(),
acb_lead_stats(),
acb_lead_tracker(),
acb_league_zones(),
acb_lineup(),
acb_match_advanced_stats(),
acb_match_header(),
acb_match_leaders(),
acb_matchlist(),
acb_next_matches(),
acb_pbp(),
acb_period_scores(),
acb_player_advanced_stats(),
acb_player_box(),
acb_player_data(),
acb_player_matches(),
acb_player_stats(),
acb_player_totals(),
acb_quickfacts(),
acb_round_matches(),
acb_search(),
acb_season_leaders(),
acb_serie(),
acb_shots(),
acb_standings(),
acb_standings_rounds(),
acb_team_box(),
acb_team_comparison(),
acb_team_leaders(),
acb_team_matches(),
acb_team_records(),
acb_team_stats(),
acb_team_totals(),
acb_teams()
Examples
# \donttest{
try(acb_calendar(season = 2027))
#> ── ACB Calendar from api2.acb.com ─────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:26:26 UTC
#> # A tibble: 306 × 25
#> competition_id edition_id season round_id round_number subphase_id
#> <int> <int> <int> <int> <int> <int>
#> 1 1 91 2027 6015 1 NA
#> 2 1 91 2027 6015 1 NA
#> 3 1 91 2027 6015 1 NA
#> 4 1 91 2027 6015 1 NA
#> 5 1 91 2027 6015 1 NA
#> 6 1 91 2027 6015 1 NA
#> 7 1 91 2027 6015 1 NA
#> 8 1 91 2027 6015 1 NA
#> 9 1 91 2027 6015 1 NA
#> 10 1 91 2027 6016 2 NA
#> # ℹ 296 more rows
#> # ℹ 19 more variables: subphase_number <int>, week_id <int>, match_id <int>,
#> # home_team_id <int>, away_team_id <int>, home_score <int>, away_score <int>,
#> # start <dttm>, status <chr>, is_on_half_time <lgl>, current_quarter <int>,
#> # home_club_id <int>, home_team <chr>, home_team_abbr <chr>,
#> # away_club_id <int>, away_team <chr>, away_team_abbr <chr>,
#> # ticketing_link <chr>, broadcasters <chr>
# }