Skip to contents

Get the full team directory and conference metadata for a season from the CollegeBasketballData API.

Usage

cbbd_teams_directory(season = most_recent_mbb_season())

Arguments

season

(integer required): Season, in 4-digit format ending-year (e.g. 2025 for the 2024-25 season). Defaults to most_recent_mbb_season().

Value

A named list of two hoopR_data tibbles, teams and conferences. Both carry the season as attributes: season (integer) and season_label (character, the upstream season label).

teams: one row per team

col_nametypedescription
idintegerCollegeBasketballData team id.
source_idcharacterSource (ESPN) team id.
schoolcharacterSchool name.
mascotcharacterTeam mascot.
abbreviationcharacterTeam abbreviation.
display_namecharacterFull display name (school and mascot).
short_display_namecharacterShort display name.
conference_idintegerConference id for the season; joins to id in conferences.

conferences: one row per conference

col_nametypedescription
idintegerConference id.
namecharacterConference name.
abbreviationcharacterConference abbreviation.

See also

Other CBD Teams Functions: cbbd_teams(), cbbd_teams_season_overview()

Examples

# \donttest{
  try(cbbd_teams_directory(season = 2025))
#> ✖ 2026-10-12 03:07:19.225349: Invalid arguments or no team directory data available!
#> ✖ Args: season = 2025
#> ✖ Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> list()
# }