Skip to contents

MLB Divisions

Usage

mlb_divisions(division_id = NULL, league_id = NULL, sport_id = NULL)

Arguments

division_id

Return division(s) data for a specific division

league_id

Return division(s) data for all divisions in a specific league

sport_id

Return division(s) for all divisions in a specific sport.

Value

Returns a tibble with the following columns

col_nametypesdescription
division_idintegerMLB division ID.
division_namecharacterDivision name.
seasoncharacterSeason (YYYY).
division_name_shortcharacterShort division name.
division_linkcharacterMLB Stats API relative division link.
division_abbreviationcharacterDivision abbreviation.
has_wildcardlogicalWhether the division has a wild card.
sort_orderintegerDisplay sort order for the division.
num_playoff_teamsintegerNumber of playoff teams from the division.
activelogicalWhether the division is currently active.
league_idintegerMLB league ID.
league_linkcharacterMLB Stats API relative league link.
sport_idintegerMLB sport ID.
sport_linkcharacterMLB Stats API relative sport link.

Examples

# \donttest{
  try(mlb_divisions(sport_id = 1))
#> ── MLB Divisions data from MLB.com ────────────────── baseballr 2.0.0 ──
#>  Data updated: 2026-06-12 14:09:25 UTC
#> # A tibble: 6 × 14
#>   division_id division_name     season division_name_short division_link
#>         <int> <chr>             <chr>  <chr>               <chr>        
#> 1         200 American League … 2026   AL West             /api/v1/divi…
#> 2         201 American League … 2026   AL East             /api/v1/divi…
#> 3         202 American League … 2026   AL Central          /api/v1/divi…
#> 4         203 National League … 2026   NL West             /api/v1/divi…
#> 5         204 National League … 2026   NL East             /api/v1/divi…
#> 6         205 National League … 2026   NL Central          /api/v1/divi…
#> # ℹ 9 more variables: division_abbreviation <chr>, has_wildcard <lgl>,
#> #   sort_order <int>, num_playoff_teams <int>, active <lgl>,
#> #   league_id <int>, league_link <chr>, sport_id <int>,
#> #   sport_link <chr>
# }