Skip to contents

The divisions (preseason, regular season, play-in, playoffs, finals) of one season.

Endpoint: GET https://api.tpbl.basketball/api/events/{season}/divisions

Usage

tpbl_divisions(season)

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 raises hoopR_no_data.

Value

A hoopR_data tibble: The divisions (preseason, regular season, play-in, playoffs, finals) of one season. An empty answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py tpbl_divisions):

col_nametypedescription
seasonintegerSeason END year (2026 = the 2025-26 season), the year asked for. Null when the body was parsed without the request stamp.
season_idintegerTPBL season id (key space: TPBL seasons on api.tpbl.basketball; 1 = 2024-25, 2 = 2025-26, 3 = 2026-27): the {season_id} of the season game list and, equal to it, the {event_id} of /events/{event_id}/*. Not the GoHoops season id. Null when the body was parsed without the request stamp.
division_idintegerTPBL division id (key space: TPBL divisions, one competition phase of one season; 1, 2, 5, 6, 7 = 2024-25, 8, 9, 11, 12, 35 = 2025-26, 655, 656 = 2026-27): the {division_id} of every division route. Not the GoHoops division id.
gohoops_division_idintegerGoHoops division id (key space: GoHoops divisions; e.g. 64 = the 2024-25 preseason, 65 = the 2024-25 regular season). Not the TPBL division id.
gohoops_event_idintegerGoHoops event id (key space: GoHoops events, one per TPBL season; 319 = 2024-25, 490 = 2025-26, 613 = 2026-27). Not the TPBL season id and not the GoHoops season id.
namecharacterDivision name (Traditional Chinese: preseason (warm-up games), regular season, postseason challenge (play-in round), playoffs, finals).
statuscharacterDivision status: COMPLETED or IN_PROGRESS.

Details

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

 tpbl_divisions(season = 2026)