Skip to contents

Standings of one phase of a competition: record, points, home/away split, last five and streak.

Endpoint: GET https://bnxt.sportpress.info/api/v1/standings/competition/{competition_id}/phase/{phase_id}

Usage

sportpress_standings(competition_id, phase_id)

Arguments

competition_id

(required) Competition id (integer), ONE per season of the league: 24 = 2025-26, 25 = 2026-27 (sportpress_phases() maps a season to it).

phase_id

(required) Phase id (integer) of the competition, from sportpress_phases() (phase_id).

Value

A hoopR_data tibble: Standings of one phase of a competition: record, points, home/away split, last five and streak. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py sportpress_standings):

col_nametypedescription
competition_idintegerCompetition id (key space: sportpress competitions): ONE season of the league (24 = 2025-26, 25 = 2026-27). Not the season number. The key of the standings, ranking, slider and box routes.
phase_idintegerPhase id (key space: sportpress phases), a stage of one competition such as the regular season or the playoffs; new every season.
competition_team_idintegerCompetition-team id (key space: sportpress competition teams): a team in ONE competition, so a club has a new id every season (Antwerp = 3 in 2021-22, 506 in 2025-26, 541 in 2026-27). uu_team_id is the stable club key.
teamcharacterTeam display name including the sponsor; varies with language and playoff suffixes: never join on it.
team_short_namecharacterThree-letter club code (ANT, MON, ...), stable across seasons in the samples.
club_idintegerCountry of the team (key space: sportpress clubs): 1 = Belgium, 2 = Netherlands. The provider calls the country a club.
club_namecharacterCountry name in English, Belgium or Netherlands.
positionintegerRank in the table, 1 = first.
playedintegerGames played in the phase (win + loss + even).
winintegerGames won in the phase.
lossintegerGames lost in the phase.
evenintegerGames drawn; 0 in every sample (basketball has no draws).
scoreintegerPoints scored in the phase.
againstintegerPoints conceded in the phase.
score_differenceintegerscore - against.
percentdoubleWin percentage 0-100, rounded to 1 decimal.
pointintegerLeague points: 2 per win plus 1 per loss.
point_percentdoubleShare of the possible league points won, 0-1 rounded to 2 decimals.
home_winintegerWins in home games.
home_lossintegerLosses in home games.
away_winintegerWins in away games.
away_lossintegerLosses in away games.
last5_winintegerWins among the last five games.
last5_lossintegerLosses among the last five games.
streak_is_winlogicalTrue for a winning streak, false for a losing one.
streak_countintegerLength of the current streak in games.
groupcharacterGroup label for split phases; null in every sample.

Details

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

Examples

# \donttest{
  try(sportpress_standings(competition_id = 24, phase_id = 169))
#> ── BNXT League Standings from Sportpress ──────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:34:40 UTC
#> # A tibble: 18 × 27
#>    competition_id phase_id competition_team_id team      team_short_name club_id
#>             <int>    <int>               <int> <chr>     <chr>             <int>
#>  1             24      169                 506 Windrose… ANT                   1
#>  2             24      169                 504 Filou Oo… OOS                   1
#>  3             24      169                 528 Partena … AAL                   1
#>  4             24      169                 536 House of… KOR                   1
#>  5             24      169                 510 Hubo Lim… LIM                   1
#>  6             24      169                 526 Heroes D… DBO                   2
#>  7             24      169                 512 Donar Gr… GRO                   2
#>  8             24      169                 534 Kangoero… MEC                   1
#>  9             24      169                 532 Brussels… BRU                   1
#> 10             24      169                 522 Zorg en … LEI                   2
#> 11             24      169                 502 Val-Dieu… CHA                   1
#> 12             24      169                 530 AB InBev… LEU                   1
#> 13             24      169                 524 Den Held… DHE                   2
#> 14             24      169                 516 Landsted… ZWO                   2
#> 15             24      169                 520 LWD Bask… LWD                   2
#> 16             24      169                 508 Union Mo… MON                   1
#> 17             24      169                 518 Zeeuw & … RCB                   2
#> 18             24      169                 514 PrismaWo… BAL                   2
#> # ℹ 21 more variables: club_name <chr>, position <int>, played <int>,
#> #   win <int>, loss <int>, even <int>, score <int>, against <int>,
#> #   score_difference <int>, percent <dbl>, point <int>, point_percent <dbl>,
#> #   home_win <int>, home_loss <int>, away_win <int>, away_loss <int>,
#> #   last5_win <int>, last5_loss <int>, streak_is_win <lgl>, streak_count <int>,
#> #   group <chr>
# }