Get ESPN WNBA Free Agents

Get ESPN WNBA Free Agents

Get ESPN WNBA Free Agents

Usage

espn_wnba_freeagents(season = most_recent_wnba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent WNBA season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(wehoop.proxy = ...).

Value

A wehoop_data tibble with one row per free agent:

col_name	types	description
season	integer	Season identifier (4-digit year or 'YYYY-YY' string).
athlete_id	character	Unique athlete identifier (ESPN).
athlete_name	character	Athlete display name (ESPN).
position	character	Listed roster position (G, F, C, etc.).
prior_team_id	character	Unique identifier for prior team.
status	character	Status label.
signed_team_id	character	Unique identifier for signed team.
signed_date	character	Date in YYYY-MM-DD format.
contract_value	character	Contract value.
contract_term_years	character	Contract term years.

Details

Calls the ESPN core-v2 endpoint https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/{year}/freeagents. As of 2026-05, this endpoint returns HTTP 500 for every season tested and there is no documented replacement; the function consequently returns an empty tibble and emits a CLI error message. It is retained so that downstream code does not break if ESPN restores the endpoint, but should not be relied on in the meantime.

See also

Other ESPN WNBA Functions: espn_wnba_athlete_awards(), espn_wnba_athlete_career_stats(), espn_wnba_athlete_eventlog(), espn_wnba_athlete_eventlog_v2(), espn_wnba_athlete_gamelog(), espn_wnba_athlete_info(), espn_wnba_athlete_overview(), espn_wnba_athlete_seasons(), espn_wnba_athlete_splits(), espn_wnba_athlete_statisticslog(), espn_wnba_athlete_stats(), espn_wnba_athletes_index(), espn_wnba_award(), espn_wnba_calendar(), espn_wnba_coach_season(), espn_wnba_coaches(), espn_wnba_conferences(), espn_wnba_draft(), espn_wnba_draft_athletes(), espn_wnba_draft_pick(), espn_wnba_draft_rounds(), espn_wnba_draft_status(), espn_wnba_event_broadcasts(), espn_wnba_event_odds(), espn_wnba_event_officials(), espn_wnba_event_powerindex(), espn_wnba_event_predictor(), espn_wnba_event_probabilities(), espn_wnba_event_propbets(), espn_wnba_event_situation(), espn_wnba_franchise(), espn_wnba_franchises(), espn_wnba_futures(), espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_injuries(), espn_wnba_leaders(), espn_wnba_news(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_powerindex(), espn_wnba_scoreboard(), espn_wnba_season_awards(), espn_wnba_season_group(), espn_wnba_season_group_children(), espn_wnba_season_group_teams(), espn_wnba_season_groups(), espn_wnba_season_info(), espn_wnba_season_leaders(), espn_wnba_season_ranking(), espn_wnba_season_rankings(), espn_wnba_season_type(), espn_wnba_season_types(), espn_wnba_season_week(), espn_wnba_season_weeks(), espn_wnba_seasons(), espn_wnba_standings(), espn_wnba_team(), espn_wnba_team_box(), espn_wnba_team_injuries(), espn_wnba_team_leaders(), espn_wnba_team_news(), espn_wnba_team_record(), espn_wnba_team_roster(), espn_wnba_team_schedule(), espn_wnba_team_season_profile(), espn_wnba_team_season_roster(), espn_wnba_team_stats(), espn_wnba_teams(), espn_wnba_transactions(), espn_wnba_venues(), espn_wnba_week_ranking(), espn_wnba_week_rankings()

Author

Saiem Gilani

Examples

# \donttest{
  espn_wnba_freeagents(season = 2025)
#> ✖ 2026-05-19 01:33:10.481444: Failed to retrieve ESPN WNBA free agents for season 2025
#> ✖ Args: season = 2025
#> ✖ Error: The API returned an error
#> data frame with 0 columns and 0 rows
# }