Match header: teams, status, score, bonus, current period and the content the site offers.
One row. status is the API's matchStatus (FINALIZED once over); home_score / away_score are the
live or final score; time_left is the period clock as 'mm:ss'; start is UTC; the has_* flags say
which panels (overview, play-by-play, box score, advanced stats) the site offers. team_id is the
season-team entry, club_id the stable club.
Endpoint: GET https://api2.acb.com/api/matchdata/MatchHeader/match-header
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.
Value
A hoopR_data tibble with one row per game.
Its columns are listed in return_columns
(subset(return_columns, fn == "acb_match_header")) and in the searchable
return columns article.
Details
Legal notice (the aviso legal of acb.com): ACEB, S.A.U. claims intellectual property in the site's databases (the EU sui generis database right) among its other content. It authorises viewing and private copies for personal or journalistic use with the source credited, and requires prior express consent for distribution, reproduction or public communication. These wrappers fetch on your behalf for your own use; check the notice before you republish the data. robots.txt allows the paths.
Unofficial and unsupported: api2.acb.com is the .NET API behind acb.com and live.acb.com, not a documented public API. It needs the header
X-APIKEY, a public key shipped in acb.com's bundle: the runtime sends the documented value ($ACB_API_KEYoverrides it), re-reads the live bundle once on a 401, and never prints the key.Seasons: the API keys a season by
editionId= season START year - 1935 (91 = 2026-27, 48 = 1983-84, the first). The wrappers takeseason, the END year (2027 = 2026-27), and the runtime sendseditionId = season - 1936. A route that omitsseasonserves the current edition.team_idis a season-team entry (new every season);club_idis the stable club.Coverage: box scores from 1983-84 (old seasons carry only the whole-game period, quarter 0); play-by-play and shots from 2016-17 (earlier games answer empty lists, which raise
hoopR_no_data). Shot coordinates come in two systems, split by match id: millimetres from the attacked basket from 2020-21 (coord_systemmm), a 0-100 full-court percent grid before (grid). A game that is not finished (matchFinishedfalse) raiseshoopR_asset_fetchfor the routes that report it.Errors are classed conditions, all inheriting
hoopR_error:hoopR_no_data(HTTP 404 / 204, a route whose rows are empty: an unknown id, a game outside a playoff series, play-by-play or shots before 2016-17, a club with no games that season),hoopR_bad_request(a missing, unknown or non-integer argument or a season before 1984, raised before any request; HTTP 400 / 422) andhoopR_asset_fetch(a key the API still rejects after one re-read of the bundle, any other non-200 after three attempts, a non-JSON orproblem+jsonbody, an error envelope or empty stub, a body for another season, round, club, player or match, a game that is not finished). Wrappers raise; they never warn and return empty.
See also
family_acb lists every function in this family.
Examples
# \donttest{
try(acb_match_header(match_id = 105401))
#> ── ACB Match Header from api2.acb.com ─────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:10:11 UTC
#> # A tibble: 1 × 26
#> match_id competition_id start status is_on_half_time time_left
#> <int> <int> <dttm> <chr> <lgl> <chr>
#> 1 105401 1 2026-10-11 17:00:00 FINALIZ… FALSE 00:00
#> # ℹ 20 more variables: current_quarter <int>, home_score <int>,
#> # away_score <int>, home_bonus <int>, away_bonus <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>, edition_id <int>, season <int>, has_overview <lgl>,
#> # has_play_by_play <lgl>, has_boxscore <lgl>, has_advanced <lgl>,
#> # highlights_url <chr>
# }
