Skip to contents

Returns metadata for one season-type within an MBB season: name, abbreviation, start / end dates, and whether it carries groups, standings, or playoff legs.

Returns metadata for one season-type within an NBA season: name, abbreviation, start / end dates, and whether it carries groups, standings, or playoff legs.

Usage

espn_mbb_season_type(season_type = 2L, season = most_recent_mbb_season(), ...)

espn_nba_season_type(season_type = 2L, season = most_recent_nba_season(), ...)

Arguments

season_type

Season-type id (1 = preseason, 2 = regular (default), 3 = postseason, 4 = off-season).

season

Season year. Defaults to most recent MBB season.

...

Additional arguments; currently unused.

Value

A hoopR_data tibble with one row per season type.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
typeintegerNumeric type code.
namecharacterDisplay name (e.g. "Regular Season").
abbreviationcharacterShort code (e.g. "reg").
yearintegerYear stamp.
start_datecharacterISO 8601 start date.
end_datecharacterISO 8601 end date.
has_groupslogicalWhether groups exist for this type.
has_standingslogicalWhether standings exist.
has_legslogicalWhether playoff legs exist.
slugcharacterURL slug.
groups_refcharacter$ref to the groups endpoint.
weeks_refcharacter$ref to the weeks endpoint.
leaders_refcharacter$ref to the leaders endpoint.

A hoopR_data tibble with one row per season type.

col_nametypesdescription
leaguecharacterLeague slug.
seasonintegerSeason year.
season_typeintegerSeason-type id.
typeintegerNumeric type code.
namecharacterDisplay name (e.g. "Regular Season").
abbreviationcharacterShort code (e.g. "reg").
yearintegerYear stamp.
start_datecharacterISO 8601 start date.
end_datecharacterISO 8601 end date.
has_groupslogicalWhether groups exist for this type.
has_standingslogicalWhether standings exist.
has_legslogicalWhether playoff legs exist.
slugcharacterURL slug.
groups_refcharacter$ref to the groups endpoint.
weeks_refcharacter$ref to the weeks endpoint.
leaders_refcharacter$ref to the leaders endpoint.

Details

Get ESPN MBB Season-Type Detail

Get ESPN NBA Season-Type Detail

See also

family_espn_mbb lists every function in this family.

family_espn_nba lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_season_type(season_type = 2, season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Season Type Detail ────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:32 UTC
#> # A tibble: 1 × 16
#>   league   season season_type  type name  abbreviation  year start_date end_date
#>   <chr>     <int>       <int> <int> <chr> <chr>        <int> <chr>      <chr>   
#> 1 mens-co…   2025           2     2 Regu… reg           2025 2024-11-0… 2025-03…
#> # ℹ 7 more variables: has_groups <lgl>, has_standings <lgl>, has_legs <lgl>,
#> #   slug <chr>, groups_ref <chr>, weeks_ref <chr>, leaders_ref <chr>
# }
# \donttest{
  espn_nba_season_type(season_type = 2, season = 2025)
#> ── ESPN NBA Season Type Detail ────────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:32 UTC
#> # A tibble: 1 × 16
#>   league season season_type  type name    abbreviation  year start_date end_date
#>   <chr>   <int>       <int> <int> <chr>   <chr>        <int> <chr>      <chr>   
#> 1 nba      2025           2     2 Regula… reg           2025 2024-10-2… 2025-04…
#> # ℹ 7 more variables: has_groups <lgl>, has_standings <lgl>, has_legs <lgl>,
#> #   slug <chr>, groups_ref <chr>, weeks_ref <chr>, leaders_ref <chr>
# }