The roster of all teams in a league.

team_roster(
  leagueId = ffl_id(),
  leagueHistory = FALSE,
  scoringPeriodId = NULL,
  ...
)

Arguments

leagueId

Numeric league ID or ESPN fantasy page URL. Defaults to getOption("fflr.leagueId"). Function fails if no ID is found.

leagueHistory

logical; Should the leagueHistory version of the API be called? If TRUE, a list of results is returned, with one element for each historical year of the league.

scoringPeriodId

Integer week of NFL season. By default, NULL will use the current week (see ffl_week()). Scoring periods are always one week in length, whereas matchups might be longer.

...

Additional queries passed to httr::GET(). Arguments are converted to a named list and passed to query alongside view.

Value

A dataframe (or list) with league teams.

See also

Other roster functions: best_roster(), roster_score(), start_roster()

Examples

team_roster(leagueId = "42654852", scoringPeriodId = 1)
#> $AUS
#> # A tibble: 16 × 16
#>    seasonId scoringPeriodId teamId abbrev lineupSlot playerId firstName lastName
#>       <int>           <int>  <int> <fct>  <fct>         <int> <chr>     <chr>   
#>  1     2025               1      1 AUS    QB          3918298 Josh      Allen   
#>  2     2025               1      1 AUS    RB          4430807 Bijan     Robinson
#>  3     2025               1      1 AUS    RB          4047365 Josh      Jacobs  
#>  4     2025               1      1 AUS    WR          4241389 CeeDee    Lamb    
#>  5     2025               1      1 AUS    WR          4374302 Amon-Ra   St. Bro…
#>  6     2025               1      1 AUS    TE          4430027 Sam       LaPorta 
#>  7     2025               1      1 AUS    FLEX        4047646 A.J.      Brown   
#>  8     2025               1      1 AUS    D/ST         -16023 Steelers  D/ST    
#>  9     2025               1      1 AUS    K           4362081 Cameron   Dicker  
#> 10     2025               1      1 AUS    BE          4239993 Tee       Higgins 
#> 11     2025               1      1 AUS    BE            16800 Davante   Adams   
#> 12     2025               1      1 AUS    BE          4430878 Jaxon     Smith-N…
#> 13     2025               1      1 AUS    BE          4685382 Omarion   Hampton 
#> 14     2025               1      1 AUS    BE          4241416 Chuba     Hubbard 
#> 15     2025               1      1 AUS    BE          4047650 DK        Metcalf 
#> 16     2025               1      1 AUS    BE          4683062 Xavier    Worthy  
#> # ℹ 8 more variables: proTeam <fct>, position <fct>, injuryStatus <chr>,
#> #   projectedScore <dbl>, actualScore <dbl>, percentStarted <dbl>,
#> #   percentOwned <dbl>, percentChange <dbl>
#> 
#> $BOS
#> # A tibble: 16 × 16
#>    seasonId scoringPeriodId teamId abbrev lineupSlot playerId firstName lastName
#>       <int>           <int>  <int> <fct>  <fct>         <int> <chr>     <chr>   
#>  1     2025               1      2 BOS    QB          3916387 Lamar     Jackson 
#>  2     2025               1      2 BOS    RB          4429795 Jahmyr    Gibbs   
#>  3     2025               1      2 BOS    RB          4242335 Jonathan  Taylor  
#>  4     2025               1      2 BOS    WR          4362628 Ja'Marr   Chase   
#>  5     2025               1      2 BOS    WR          4595348 Malik     Nabers  
#>  6     2025               1      2 BOS    TE          4036133 T.J.      Hockens…
#>  7     2025               1      2 BOS    FLEX        4426502 Drake     London  
#>  8     2025               1      2 BOS    D/ST         -16034 Texans    D/ST    
#>  9     2025               1      2 BOS    K           3953687 Brandon   Aubrey  
#> 10     2025               1      2 BOS    BE          4430737 Kyren     Williams
#> 11     2025               1      2 BOS    BE          4362238 Chase     Brown   
#> 12     2025               1      2 BOS    BE          4379399 James     Cook    
#> 13     2025               1      2 BOS    BE          3915511 Joe       Burrow  
#> 14     2025               1      2 BOS    BE          3054850 Alvin     Kamara  
#> 15     2025               1      2 BOS    BE          3915416 DJ        Moore   
#> 16     2025               1      2 BOS    BE          4428331 Rashee    Rice    
#> # ℹ 8 more variables: proTeam <fct>, position <fct>, injuryStatus <chr>,
#> #   projectedScore <dbl>, actualScore <dbl>, percentStarted <dbl>,
#> #   percentOwned <dbl>, percentChange <dbl>
#> 
#> $CHI
#> # A tibble: 16 × 16
#>    seasonId scoringPeriodId teamId abbrev lineupSlot playerId firstName lastName
#>       <int>           <int>  <int> <fct>  <fct>         <int> <chr>     <chr>   
#>  1     2025               1      3 CHI    QB          4040715 Jalen     Hurts   
#>  2     2025               1      3 CHI    RB          3929630 Saquon    Barkley 
#>  3     2025               1      3 CHI    RB          4429160 De'Von    Achane  
#>  4     2025               1      3 CHI    WR          4426515 Puka      Nacua   
#>  5     2025               1      3 CHI    WR          4258173 Nico      Collins 
#>  6     2025               1      3 CHI    TE          4432665 Brock     Bowers  
#>  7     2025               1      3 CHI    FLEX        4361307 Trey      McBride 
#>  8     2025               1      3 CHI    D/ST         -16016 Vikings   D/ST    
#>  9     2025               1      3 CHI    K           4689936 Jake      Bates   
#> 10     2025               1      3 CHI    BE          3116406 Tyreek    Hill    
#> 11     2025               1      3 CHI    BE          3121422 Terry     McLaurin
#> 12     2025               1      3 CHI    BE          4569618 Garrett   Wilson  
#> 13     2025               1      3 CHI    BE          4427366 Breece    Hall    
#> 14     2025               1      3 CHI    BE            16737 Mike      Evans   
#> 15     2025               1      3 CHI    BE          4259545 D'Andre   Swift   
#> 16     2025               1      3 CHI    BE          4429615 Zay       Flowers 
#> # ℹ 8 more variables: proTeam <fct>, position <fct>, injuryStatus <chr>,
#> #   projectedScore <dbl>, actualScore <dbl>, percentStarted <dbl>,
#> #   percentOwned <dbl>, percentChange <dbl>
#> 
#> $DEN
#> # A tibble: 16 × 16
#>    seasonId scoringPeriodId teamId abbrev lineupSlot playerId firstName lastName
#>       <int>           <int>  <int> <fct>  <fct>         <int> <chr>     <chr>   
#>  1     2025               1      4 DEN    QB          4426348 Jayden    Daniels 
#>  2     2025               1      4 DEN    RB          3117251 Christian McCaffr…
#>  3     2025               1      4 DEN    RB          4890973 Ashton    Jeanty  
#>  4     2025               1      4 DEN    WR          4262921 Justin    Jeffers…
#>  5     2025               1      4 DEN    WR          4432773 Brian     Thomas …
#>  6     2025               1      4 DEN    TE          3040151 George    Kittle  
#>  7     2025               1      4 DEN    FLEX        3043078 Derrick   Henry   
#>  8     2025               1      4 DEN    D/ST         -16007 Broncos   D/ST    
#>  9     2025               1      4 DEN    K           3150744 Chase     McLaugh…
#> 10     2025               1      4 DEN    BE          4596448 Bucky     Irving  
#> 11     2025               1      4 DEN    BE          4612826 Ladd      McConkey
#> 12     2025               1      4 DEN    BE          4567048 Kenneth   Walker …
#> 13     2025               1      4 DEN    BE          3045147 James     Conner  
#> 14     2025               1      4 DEN    BE          4432708 Marvin    Harriso…
#> 15     2025               1      4 DEN    BE          3116385 Joe       Mixon   
#> 16     2025               1      4 DEN    BE          3128429 Courtland Sutton  
#> # ℹ 8 more variables: proTeam <fct>, position <fct>, injuryStatus <chr>,
#> #   projectedScore <dbl>, actualScore <dbl>, percentStarted <dbl>,
#> #   percentOwned <dbl>, percentChange <dbl>
#>