The games of the round (or week) around a game.
One row per game. home_wins / home_losses / away_wins / away_losses are the teams' series record in
a playoff series (null otherwise). match_grouping is round or week. team_id columns are season-team
entries; club_id is stable.
Endpoint: GET https://api2.acb.com/api/matchdata/Menu/matchlist
Arguments
- match_id
(required) ACB match id (integer), one global sequence for every competition: legacy ids (seasons up to 2019-20) sit below about 20000 (12559 = the 2005-06 final); ids from 2020-21 start around 100000 (105401 = Barca 89-86 Valencia Basket, Liga 2026-27 round 3). A whole number; a whole double is accepted.
- round_id
(default
NULL) Round id (integer): global across seasons, not the round number (6017 = Liga 2026-27 round 3). List them withacb_competition_roundsoracb_calendar. Omitted = the current (or last) round. A whole number; a whole double is accepted.- week_id
(default
NULL) Week id (integer): global across seasons (2989 = the week of 2026-10-10). List them withacb_competition_weeks. 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_matchlist):
| col_name | type | description |
| 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. |
| round_type | character | Phase code: LR = Liga Regular (regular season), PO = playoffs (a bundle value, not in the samples); null on every row of /Menu/competition-data and /TeamProfile/next-matches |
| round_id | integer | Round id: global across seasons, not the round number (6017 = Liga 2026-27 round 3; 2600 = 2016-17 round 1) |
| round_number | integer | Round number within the phase |
| group_id | integer | Group id in group-stage competitions |
| subphase_id | integer | Sub-phase id inside a phase (a playoff round or a cup round, e.g. 291, 292, 293); null in the regular season |
| subphase_number | integer | Sub-phase number |
| week_id | integer | Week id: global across seasons (2989 = the week of 2026-10-10) |
| status | character | Match state (x-match-statuses) |
| is_on_half_time | logical | At half time (live) |
| current_quarter | integer | Current or last quarter (0 before the match and in some finished rows) |
| 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 |
| home_wins | integer | Home team's series wins before the game (playoff series only). |
| home_losses | integer | Home team's series losses before the game (playoff series only). |
| away_wins | integer | Away team's series wins before the game (playoff series only). |
| away_losses | integer | Away team's series losses before the game (playoff series only). |
| home_team_id | integer | Season-team id: one team's entry in one competition edition (4467 = Barca in Liga 2026-27, 4388 = Real Madrid in Liga 2025-26). Changes every season and competition. Joins every homeTeamId / awayTeamId / teamId / teamEditionId. Not the club id. |
| home_club_id | integer | Club id, stable across seasons and sponsor names (2 = Barca, 9 = Real Madrid, 13 = Valencia Basket): the clubId request param and every homeClubId / awayClubId. |
| home_team | character | Team name that season (sponsor names change) |
| home_team_abbr | character | Three-letter abbreviation (BAR, RMB) |
| away_team_id | integer | Season-team id: one team's entry in one competition edition (4467 = Barca in Liga 2026-27, 4388 = Real Madrid in Liga 2025-26). Changes every season and competition. Joins every homeTeamId / awayTeamId / teamId / teamEditionId. Not the club id. |
| away_club_id | integer | Club id, stable across seasons and sponsor names (2 = Barca, 9 = Real Madrid, 13 = Valencia Basket): the clubId request param and every homeClubId / awayClubId. |
| away_team | character | Team name that season (sponsor names change) |
| away_team_abbr | character | Three-letter abbreviation (BAR, RMB) |
| competition_id | integer | Competition id: 1 Liga Endesa, 2 Copa del Rey, 3 Supercopa Endesa, 10 Minicopa Endesa (x-competitions) |
| edition_id | integer | Season id (editionId) = season START year - 1935 (91 = 2026-27, 81 = 2016-17, 70 = 2005-06, 48 = 1983-84, the first). The sdv season (END year) is editionId + 1936. Season lists also carry seasonStartYear / seasonEndYear |
| season | integer | Season END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take. |
| is_selected_local | logical | Null in this list (set only in a club's game list). |
| match_grouping | character | How the list was grouped: round or week. |
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_calendar(),
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_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_matchlist(match_id = 105401))
#> ── ACB Match List from api2.acb.com ───────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:26:32 UTC
#> # A tibble: 9 × 31
#> match_id round_type round_id round_number group_id subphase_id subphase_number
#> <int> <chr> <int> <int> <int> <int> <int>
#> 1 105393 LR 6017 3 NA NA 0
#> 2 105394 LR 6017 3 NA NA 0
#> 3 105395 LR 6017 3 NA NA 0
#> 4 105396 LR 6017 3 NA NA 0
#> 5 105397 LR 6017 3 NA NA 0
#> 6 105398 LR 6017 3 NA NA 0
#> 7 105399 LR 6017 3 NA NA 0
#> 8 105400 LR 6017 3 NA NA 0
#> 9 105401 LR 6017 3 NA NA 0
#> # ℹ 24 more variables: week_id <int>, status <chr>, is_on_half_time <lgl>,
#> # current_quarter <int>, home_score <int>, away_score <int>, start <dttm>,
#> # home_wins <int>, home_losses <int>, away_wins <int>, away_losses <int>,
#> # home_team_id <int>, home_club_id <int>, home_team <chr>,
#> # home_team_abbr <chr>, away_team_id <int>, away_club_id <int>,
#> # away_team <chr>, away_team_abbr <chr>, competition_id <int>,
#> # edition_id <int>, season <int>, is_selected_local <lgl>, …
# }