Skip to contents

Load Rosters

Usage

load_rosters(
  seasons = most_recent_season(roster = TRUE),
  file_type = getOption("nflreadr.prefer", default = "rds")
)

Arguments

seasons

a numeric vector of seasons to return, defaults to returning this year's data if it is March or later. If set to TRUE, will return all available data. Data available back to 1920.

file_type

One of c("rds", "qs", "csv", "parquet"). Can also be set globally with options(nflreadr.prefer)

Value

A tibble of season-level roster data.

See also

https://nflreadr.nflverse.com/articles/dictionary_rosters.html for a web version of the data dictionary

dictionary_rosters for the data dictionary as a dataframe

Issues with this data should be filed here: https://github.com/nflverse/nflverse-data

Examples

# \donttest{
try({ # prevents cran errors
  load_rosters(2020)
})
#> ── nflverse roster data ────────────────────────────────────────────────────────
#>  Data updated: 2023-03-22 04:03:04 UTC
#> # A tibble: 2,683 × 36
#>    season team  position depth_chart_position jersey_number status     full_name
#>     <int> <chr> <chr>    <chr>                        <int> <chr>      <chr>    
#>  1   2020 ARI   DB       CB                              25 R/Injured  Johnatha…
#>  2   2020 ARI   DB       CB                              21 Active     Patrick …
#>  3   2020 ARI   DB       CB                              20 PS; Vet    Prince A…
#>  4   2020 ARI   DB       CB                              20 Active     Dre Kirk…
#>  5   2020 ARI   DB       FS                              31 R/COVID-19 Chris Ba…
#>  6   2020 ARI   DB       CB                              23 R/Injured  Robert A…
#>  7   2020 ARI   DB       FS                              28 Active     Charles …
#>  8   2020 ARI   DB       CB                              27 Active     Kevin Pe…
#>  9   2020 ARI   DB       SS                              32 Active     Budda Ba…
#> 10   2020 ARI   DB       CB                              33 Active     Byron Mu…
#> # ℹ 2,673 more rows
#> # ℹ 29 more variables: first_name <chr>, last_name <chr>, birth_date <date>,
#> #   height <int>, weight <int>, college <chr>, gsis_id <chr>, espn_id <chr>,
#> #   sportradar_id <chr>, yahoo_id <chr>, rotowire_id <chr>, pff_id <chr>,
#> #   pfr_id <chr>, fantasy_data_id <chr>, sleeper_id <chr>, years_exp <int>,
#> #   headshot_url <chr>, ngs_position <chr>, week <int>, game_type <chr>,
#> #   status_description_abbr <chr>, football_name <chr>, esb_id <chr>, …
# }