Every game of one season, all divisions, played and scheduled, with teams, venue, status and score.
Endpoint: GET https://api.tpbl.basketball/api/seasons/{season}/games
Arguments
- season
Required. Season END year (2026 = the 2025-26 season; 2025 is the first). The API keys a season by its own small integer (1, 2, 3 = 2024-25, 2025-26, 2026-27; the event id of
/events/{id}/*is the same number): the runtime reads /seasons once and sends that id, so the example URL shows the year. A year the list lacks raiseshoopR_no_data.- team_id
TPBL team id (2-8): keep only that team's games (the API's own filter). Cannot be combined with
verify. DefaultNULL: every team.- verify
Default
NULL(off). Cross-check the list for completeness: every division's completed games must equal the matches of its own standings (one extra request per division; a division whose standings are empty is checked against the team-filtered lists instead). A mismatch raiseshoopR_asset_fetch.
Value
A hoopR_data tibble with one row per game.
Its columns are listed in return_columns
(subset(return_columns, fn == "tpbl_games")) and in the searchable
return columns article.
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in tpbl_seasons().
See also
family_tpbl lists every function in this family.
Examples
# \donttest{
try(tpbl_games(season = 2026))
#> ── TPBL Games from api.tpbl.basketball ────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:18:10 UTC
#> # A tibble: 150 × 34
#> season season_id game_id gohoops_game_id division_id gohoops_division_id
#> <int> <int> <int> <int> <int> <int>
#> 1 2026 2 1371 8062 9 358
#> 2 2026 2 1372 8063 9 358
#> 3 2026 2 1373 8064 9 358
#> 4 2026 2 1374 8065 9 358
#> 5 2026 2 1375 8066 9 358
#> 6 2026 2 1376 8067 9 358
#> 7 2026 2 1377 8068 9 358
#> 8 2026 2 1378 8069 9 358
#> 9 2026 2 1379 8070 9 358
#> 10 2026 2 1380 8071 9 358
#> # ℹ 140 more rows
#> # ℹ 28 more variables: gohoops_season_id <int>, gohoops_event_id <int>,
#> # code <chr>, status <chr>, is_live <lgl>, periods <int>, game_date <date>,
#> # game_day_of_week <chr>, game_time <chr>, tipoff <dttm>, venue <chr>,
#> # attendance <int>, home_team_id <int>, home_gohoops_team_id <int>,
#> # home_gohoops_squad_id <int>, home_team <chr>, home_alt_name <chr>,
#> # home_score <int>, away_team_id <int>, away_gohoops_team_id <int>, …
# }
