Returns draft pick information for a given year.
Uses the NHL API endpoint at
api-web.nhle.com/v1/draft/picks/{year}/{round}.
When round is NULL (default) or the literal string "all", the
function takes the fast path and hits
draft/picks/{year}/all in a single request instead of looping over
rounds 1-7.
Value
A data frame (fastRhockey_data) with the following columns:
| col_name | types | description |
| round | integer | Draft round. |
| pick_in_round | integer | Pick number within the round. |
| overall_pick | integer | Overall pick number in the draft. |
| team_id | integer | Unique team identifier. |
| team_abbrev | character | Team abbreviation. |
| team_name | data.frame | Team name (localized variants). |
| team_common_name | data.frame | Team common name (localized variants). |
| team_place_name_with_preposition | data.frame | Team place name with preposition (localized). |
| display_abbrev | data.frame | Display abbreviation (localized variants). |
| team_logo_light | character | URL to the team logo (light variant). |
| team_logo_dark | character | URL to the team logo (dark variant). |
| team_pick_history | character | Team pick history string. |
| first_name | data.frame | Player first name (localized variants). |
| last_name | data.frame | Player last name (localized variants). |
| position_code | character | Player position code. |
| country_code | character | Player country code. |
| height | integer | Player height in inches. |
| weight | integer | Player weight in pounds. |
| amateur_league | character | Amateur league played in. |
| amateur_club_name | character | Amateur club played for. |
Examples
# \donttest{
try(nhl_draft_year(year = 2023, round = 1))
#> ── NHL Draft Year data from NHL.com ─────────────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-13 03:24:57 UTC
#> # A tibble: 32 × 20
#> round pick_in_round overall_pick team_id team_abbrev team_name$default $fr
#> <int> <int> <int> <int> <chr> <chr> <chr>
#> 1 1 1 1 16 CHI Chicago Blackhawks Blac…
#> 2 1 2 2 24 ANA Anaheim Ducks Duck…
#> 3 1 3 3 29 CBJ Columbus Blue Jac… Blue…
#> 4 1 4 4 28 SJS San Jose Sharks Shar…
#> 5 1 5 5 8 MTL Montréal Canadiens Cana…
#> 6 1 6 6 53 ARI Arizona Coyotes Coyo…
#> 7 1 7 7 4 PHI Philadelphia Flye… Flye…
#> 8 1 8 8 15 WSH Washington Capita… Capi…
#> 9 1 9 9 17 DET Detroit Red Wings Red …
#> 10 1 10 10 19 STL St. Louis Blues Blue…
#> # ℹ 22 more rows
#> # ℹ 14 more variables: team_common_name <df[,1]>,
#> # team_place_name_with_preposition <df[,2]>, display_abbrev <df[,1]>,
#> # team_logo_light <chr>, team_logo_dark <chr>, team_pick_history <chr>,
#> # first_name <df[,3]>, last_name <df[,4]>, position_code <chr>,
#> # country_code <chr>, height <int>, weight <int>, amateur_league <chr>,
#> # amateur_club_name <chr>
try(nhl_draft_year(year = 2023, round = "all"))
#> ── NHL Draft Year data from NHL.com ─────────────────────── fastRhockey 1.0.0 ──
#> ℹ Data updated: 2026-06-13 03:24:58 UTC
#> # A tibble: 223 × 20
#> round pick_in_round overall_pick team_id team_abbrev team_name$default $fr
#> <int> <int> <int> <int> <chr> <chr> <chr>
#> 1 1 1 1 16 CHI Chicago Blackhawks Blac…
#> 2 1 2 2 24 ANA Anaheim Ducks Duck…
#> 3 1 3 3 29 CBJ Columbus Blue Jac… Blue…
#> 4 1 4 4 28 SJS San Jose Sharks Shar…
#> 5 1 5 5 8 MTL Montréal Canadiens Cana…
#> 6 1 6 6 53 ARI Arizona Coyotes Coyo…
#> 7 1 7 7 4 PHI Philadelphia Flye… Flye…
#> 8 1 8 8 15 WSH Washington Capita… Capi…
#> 9 1 9 9 17 DET Detroit Red Wings Red …
#> 10 1 10 10 19 STL St. Louis Blues Blue…
#> # ℹ 213 more rows
#> # ℹ 14 more variables: team_common_name <df[,2]>,
#> # team_place_name_with_preposition <df[,2]>, display_abbrev <df[,1]>,
#> # team_logo_light <chr>, team_logo_dark <chr>, team_pick_history <chr>,
#> # first_name <df[,3]>, last_name <df[,4]>, position_code <chr>,
#> # country_code <chr>, height <int>, weight <int>, amateur_league <chr>,
#> # amateur_club_name <chr>
# }