Skip to contents

One team's roster in one season: player, nationality, birth date, position and jersey.

Endpoint: GET https://api.data.cebl.ca/teams/{team_id}/roster/{season}/

Usage

cebl_roster(team_id, season)

Arguments

team_id

(required) CEBL team id of that season (team_id in cebl_standings), e.g. 20 (Ottawa BlackJacks).

season

(required) Season: the calendar year it is played in (May to August) = the sdv END year (2025 = the 2025 season). The CEBL's first season is 2019. A season with no data answers hoopR_no_data.

Value

A hoopR_data tibble: One team's roster in one season: player, nationality, birth date, position and jersey. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py cebl_roster):

col_nametypedescription
seasonintegerSeason of the roster asked for (from the request; the body does not echo it).
team_idintegerCEBL team id of the roster asked for (from the request; the body does not echo it).
player_idintegerCEBL player id (its own key space). Joins /players/{player_id}/ and id in the other player rows. Genius LiveStats data.json carries no person id, so the join to Genius play-by-play is by name, team and jersey number (unverified).
full_namecharacterPlayer's full name.
nationalitycharacterNationality: an upper-case English country name ('CANADA', 'UNITED STATES', 'SOUTH SUDAN'); null when unknown.
birth_dateDateDate of birth, YYYY-MM-DD (players' public bio field); null when unknown.
positioncharacterPlaying position: G (guard), F (forward), C (center), or a combination such as 'C/F'; null when unknown.
jersey_numbercharacterJersey number, as a string of up to 2 characters ('0', '00' and '1' are distinct); null when unknown.
photo_urlcharacterPlayer headshot URL on the Genius Sports image CDN (images.statsengine.playbyplay.api.geniussports.com).

Details

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

Examples

# \donttest{
  try(cebl_roster(team_id = 14, season = 2025))
#> ── CEBL Team Roster from the CEBL Stats API ───────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:27:58 UTC
#> # A tibble: 14 × 9
#>    season team_id player_id full_name         nationality   birth_date position
#>     <int>   <int>     <int> <chr>             <chr>         <date>     <chr>   
#>  1   2025      14     64732 Curtis Hollis     UNITED STATES 1998-04-25 F       
#>  2   2025      14       150 Kimbal Mackenzie  CANADA        1996-09-16 G       
#>  3   2025      14       158 Antonio Davis Jr. UNITED STATES 1995-03-15 F       
#>  4   2025      14       155 Khalil Ahmad      UNITED STATES 1996-12-24 G       
#>  5   2025      14        25 Ahmed Hill        UNITED STATES 1996-03-21 G       
#>  6   2025      14       164 Edward Ekiyor     CANADA        1997-05-03 F       
#>  7   2025      14    410754 Ron Curry         UNITED STATES 1993-07-12 G       
#>  8   2025      14     43599 Nathan Cayo       CANADA        1997-10-27 F       
#>  9   2025      14    422565 Connor Vreeken    CANADA        2000-09-25 G       
#> 10   2025      14     16088 Gatluak James     CANADA        2001-04-12 G       
#> 11   2025      14        79 Meshack Lufile    CANADA        1992-10-21 F       
#> 12   2025      14        14 Elijah Lufile     CANADA        1997-11-07 F       
#> 13   2025      14       444 Guillaume Boucard CANADA        1990-03-16 F       
#> 14   2025      14      3719 Jahvon Blair      CANADA        1998-03-27 G       
#> # ℹ 2 more variables: jersey_number <chr>, photo_url <chr>
# }