Skip to contents

Every configured EASL season (the four editions 2023-24 to 2026-27) with its DataCore season id and END year.

Endpoint: GET https://easl.joshricha.com/api/v1/metadata/seasons

Usage

easl_seasons()

Value

A hoopR_data tibble: Every configured EASL season (the four editions 2023-24 to 2026-27) with its DataCore season id and END year. An empty answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py easl_seasons):

col_nametypedescription
seasonintegerSeason END year (2026 = EASL 25-26), derived as year + 1.
season_idcharacterseasonId: DataCore season UUID v1 (key space: EASL seasons; one per edition: 57cefc32... is 2024-25). Joins the seasonId query parameter of /matches, /standings, /leaders, /players and the /teams/{teamId} routes, the seasonId of every fixture and leader row, and the season half of a team-fixture stage.id.
season_row_idintegerThe sync server's own integer row id (1 = 2024-25, 2 = 2025-26, 3 = 2023-24, 4 = 2026-27: insertion order, not chronological). Not a DataCore id.
yearintegerSTART year of the season (2024 = EASL 24-25, which runs 2024-10 to 2025-03). sdv season (END year) = year + 1.
namecharacterSeason label ('EASL 24-25' = 2024-25).
name_latincharacterSeason label in Latin script; null on some seasons.
statuscharacterCOMPLETE for a finished season, ACTIVE for the current one (the default of every season route).
start_dateDateFirst day of the season, local date YYYY-MM-DD.
end_dateDateLast scheduled day of the season, local date YYYY-MM-DD.
competition_idcharacterDataCore competition UUID v1 (key space: competitions); the same 77a790d8-ad01-11ed-8355-01b87a3904c0 on all four seasons: EASL is one competition with one season per edition.
profile_idcharacterDataCore profile UUID v1 of the competition (joins nothing in this API).
organization_idcharacterDataCore organisation id of the league: b1e0z (EASL) on every row.
age_groupcharacterAge group of the competition: SENIOR.
event_typecharacterDataCore event type: FIXTURE (a game schedule).
gendercharacterMALE (EASL is a men's competition).
representationcharacterCLUB (club teams, not national teams).
season_typecharacterDataCore season type: SEASON.
standardcharacterCompetition standard: ELITE.
created_atcharacterWhen the sync server inserted the row, 'YYYY-MM-DD HH:MM:SS' (a different format from updatedAt; zone unstated, UTC assumed).
updated_atcharacterWhen the sync server last synced the row, ISO 8601 with milliseconds and Z (UTC).

Details

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

Examples

# \donttest{
  try(easl_seasons())
#> ── EASL Seasons from easl.joshricha.com ───────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:28:21 UTC
#> # A tibble: 4 × 20
#>   season season_id        season_row_id  year name  name_latin status start_date
#>    <int> <chr>                    <int> <int> <chr> <chr>      <chr>  <date>    
#> 1   2025 57cefc32-5ace-1…             1  2024 EASL… EASL 24-25 COMPL… 2024-10-02
#> 2   2026 77441bb3-9759-1…             2  2025 EASL… NA         COMPL… 2025-10-08
#> 3   2024 c24ce68a-6420-1…             3  2023 EASL… NA         COMPL… 2023-10-11
#> 4   2027 1409787d-a683-1…             4  2026 EASL… NA         ACTIVE 2026-10-03
#> # ℹ 12 more variables: end_date <date>, competition_id <chr>, profile_id <chr>,
#> #   organization_id <chr>, age_group <chr>, event_type <chr>, gender <chr>,
#> #   representation <chr>, season_type <chr>, standard <chr>, created_at <chr>,
#> #   updated_at <chr>
# }