Skip to contents

Wraps GET https://www.shl.se/api/sports-v2/athlete-details/{athlete_uuid} of the SHL site API (www.shl.se). Unofficial use of a public source; seasons are END years (2026 = 2025/26) and are mapped to the site's ssgt uuids through /statistics-v2/layout-info.

Usage

shl_athlete_details(athlete_uuid, return_parsed = TRUE)

Arguments

athlete_uuid

Athlete uuid (stats-info stats[].info.uuid, roster rows, or athlete-details).

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw decoded JSON as a list.

Value

A fastRhockey_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_nametypedescription
athlete_data_uuidcharacterAthlete uuid (platform key space; qQ9-... or 10-char form); joins to the athlete routes and stats-info stats[].info.uuid. Not the isa or ramses_legacy id.
athlete_data_contact_infocharacterContact info (null in captures).
athlete_data_created_atcharacterRecord creation time (ISO 8601; often null).
athlete_data_created_bycharacterRecord creator (site instance id; often null).
athlete_data_creator_sitecharacterSite that created the record (null in captures).
athlete_data_heightintegerHeight of the player in centimetres.
athlete_data_date_of_birthcharacterDate of birth (YYYY-MM-DD).
athlete_data_deletedlogicalSoft-delete flag of the record (false in every sample).
athlete_data_first_namecharacterGiven (first) name of the player.
athlete_data_gendercharacterSex of the athlete or team (male / female).
athlete_data_last_modifiedcharacterRecord last-modified time (ISO 8601).
athlete_data_last_namecharacterSurname (family name) of the player.
athlete_data_metadatacharacterFree-form metadata.
athlete_data_nationalitycharacterNationality (ISO country code).
athlete_data_shootscharacterShooting side (L / R; Left / Right).
athlete_data_weightintegerWeight of the player in kilograms.
athlete_data_player_ext_idscharacterExternal ids of the athlete (isa, ramses_legacy, ramses_generic_legacy, ramses_merged).

Errors

fastRhockey_no_data: the host answered 404, an empty body (gameday routes before 2023/24), a table with no rows, or the season and game type are not in layout-info. fastRhockey_asset_fetch: any other non-2xx answer or a dead connection after retries, a non-JSON or error-envelope 200, a stats-info page that reaches count or falls short of its totalCount, or a body for another game, team, athlete or ssgt than the one asked for. fastRhockey_bad_request: a 400 / 422, a season that is not a year, or an argument outside its choices.

Examples

# \donttest{
  shl_athlete_details(athlete_uuid = "qQ9-349c7WDv6")
#> ── SHL Athlete Details Information from www.shl.se ─── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:59:07 UTC
#> # A tibble: 1 × 17
#>   athlete_data_uuid athlete_data_contact_info athlete_data_created_at 
#>   <chr>             <chr>                     <chr>                   
#> 1 qQ9-349c7WDv6     NA                        2024-06-24T07:49:36.000Z
#> # ℹ 14 more variables: athlete_data_created_by <chr>,
#> #   athlete_data_creator_site <chr>, athlete_data_height <int>,
#> #   athlete_data_date_of_birth <chr>, athlete_data_deleted <lgl>,
#> #   athlete_data_first_name <chr>, athlete_data_gender <chr>,
#> #   athlete_data_last_modified <chr>, athlete_data_last_name <chr>,
#> #   athlete_data_metadata <chr>, athlete_data_nationality <chr>,
#> #   athlete_data_shoots <chr>, athlete_data_weight <int>, …
# }