The date and method of each player's acquisition onto a fantasy roster.

player_acquire(leagueId = ffl_id(), leagueHistory = FALSE, ...)

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.

...

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

Value

A data frame of roster players with acquisition method and date.

Examples

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