League table of one division: rank, record, games behind and streak.
Endpoint: GET https://api.tpbl.basketball/api/divisions/{division_id}/games/standings
Value
A hoopR_data tibble: League table of one division: rank, record, games behind and streak. An empty answer
raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py tpbl_standings):
| col_name | type | description |
| division_id | integer | TPBL 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. |
| rank | integer | Rank in the division, 1-based. |
| team_id | integer | TPBL team id (key space: TPBL teams = franchises, 2-8 so far; stable across seasons): the {team_id} of the division team routes. Not the GoHoops franchise id and not the squad id. |
| gohoops_team_id | integer | GoHoops franchise id (key space: GoHoops franchises, 940-946; stable across seasons; = the TPBL team id + 938). |
| gohoops_squad_id | integer | GoHoops squad id (key space: GoHoops squads = one team in one season: 8209-8215 in 2024-25, 11931-11937 in 2025-26, 15536-15542 in 2026-27; it changes every season). |
| team | character | Team name in Traditional Chinese with the sponsor (Kaohsiung Aquas, Formosa Dreamers, Hsinchu Lioneers, Taoyuan Leopards, New Taipei CTBC DEA, New Taipei Kings, Taipei Mars). |
| alt_name | character | Lowercase English slug of the team: aquas, dreamers, lioneers, leopards, dea, kings, mars. |
| won | integer | Games won in the division so far. |
| lost | integer | Games lost in the division so far. |
| drawn | integer | Games drawn (always 0 in basketball). |
| games_behind | double | Games behind the leader (0 for the leader); a whole number in every captured division, read as a float so half games cannot break the dtype. |
| streak | character | Current streak: 'W' + count for wins, 'L' + count for losses (W2 = two straight wins). |
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in tpbl_seasons().
See also
Other TPBL Functions:
tpbl_box_player_periods(),
tpbl_box_players(),
tpbl_box_team_periods(),
tpbl_box_teams(),
tpbl_divisions(),
tpbl_game(),
tpbl_games(),
tpbl_player_games(),
tpbl_player_shots(),
tpbl_referees(),
tpbl_roster(),
tpbl_seasons(),
tpbl_standings_against(),
tpbl_team_shots(),
tpbl_teams()
Examples
# \donttest{
try(tpbl_standings(division_id = 2))
#> ── TPBL Standings from api.tpbl.basketball ────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:35:11 UTC
#> # A tibble: 7 × 12
#> division_id rank team_id gohoops_team_id gohoops_squad_id team alt_name
#> <int> <int> <int> <int> <int> <chr> <chr>
#> 1 2 1 7 945 8214 新北國王 kings
#> 2 2 2 3 941 8210 福爾摩沙夢想家…… dreamers
#> 3 2 3 2 940 8209 高雄全家海神…… aquas
#> 4 2 4 8 946 8215 臺北台新戰神…… mars
#> 5 2 5 5 943 8212 桃園台啤永豐雲豹…… leopards
#> 6 2 6 6 944 8213 新北中信特攻…… dea
#> 7 2 7 4 942 8211 新竹御嵿攻城獅…… lioneers
#> # ℹ 5 more variables: won <int>, lost <int>, drawn <int>, games_behind <dbl>,
#> # streak <chr>
# }
