The roster of all teams in a league.
team_roster(
leagueId = ffl_id(),
leagueHistory = FALSE,
scoringPeriodId = NULL,
...
)
Numeric league ID or ESPN fantasy page URL. Defaults to
getOption("fflr.leagueId")
. Function fails if no ID is found.
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.
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
.
A dataframe (or list) with league teams.
Other roster functions:
best_roster()
,
roster_score()
,
start_roster()
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>
#>