Skip to contents

One round (journee) of a phase with its games (get_rencontrestours). A round body publishes UTC ISO times and no win type: game_datetime is converted to Europe/Paris and decision is NA.

Usage

magnus_round_games(phase_id, round, return_parsed = TRUE)

Arguments

phase_id

Phase id (phase_id of magnus_phases()), e.g. 714 (the 2026-27 regular season).

round

Round number (tour), 1-based. Shadows the base function.

return_parsed

Parse the payload into a tibble (default TRUE). Pass FALSE for the raw JSON envelope as a list.

Value

A tibble (return_parsed = TRUE), else the raw envelope list:

col_nametypedescription
game_idintegerGame id (integer join key), the game_id argument of magnus_game, magnus_pbp, magnus_lineups and magnus_shootout.
seasonintegerSeason by its END year (2027 = 2026-27).
competition_idintegerCompetition (season) id (integer).
phase_idintegerPhase id (integer; regular season, playoffs, relegation).
phasecharacterPhase name in French (e.g., "Saison régulière").
roundintegerRound (journée) number within the phase.
game_datetimePOSIXctScheduled start, Europe/Paris time (get_rencontres publishes local time, a round body UTC; both are converted).
statuscharacterGame state: final, in_progress or scheduled.
decisioncharacterHow a final game was decided: regulation, overtime or shootout; null until the game is final (round bodies carry no decision, so null there too).
home_team_idintegerTeam id of the home team (integer).
home_teamcharacterDisplay name of the home team.
home_team_abbreviationcharacterAbbreviation of the home team.
away_team_idintegerTeam id of the away team (integer).
away_teamcharacterDisplay name of the away team.
away_team_abbreviationcharacterAbbreviation of the away team.
home_scoreintegerGoals of the home team (shootout winner included in the final score); null until the game starts (unplayed games publish a 0-0 placeholder).
away_scoreintegerGoals of the away team; null until the game starts.
home_team_participant_idintegerTeam participant id of the home team in this phase (integer; its own key space, joins team_participant_id of the standings; not a team id).
away_team_participant_idintegerTeam participant id of the away team in this phase (integer; joins team_participant_id of the standings).
venue_idintegerRink id (integer).
venuecharacterName of the rink (arena).
game_labelcharacterGame label as published ("HOME / AWAY").

Examples

# \donttest{
  try(magnus_round_games(phase_id = 714, round = 1))
#> ── Ligue Magnus Round Games Information from liguemagnus.com ───────────────────
#> ℹ Data updated: 2026-10-13 01:56:50 UTC
#> # A tibble: 6 × 22
#>   game_id season competition_id phase_id phase  round game_datetime       status
#>     <int>  <int>          <int>    <int> <chr>  <int> <dttm>              <chr> 
#> 1   77745   2027            240      714 Saiso…     1 2026-09-15 20:00:00 final 
#> 2   77746   2027            240      714 Saiso…     1 2026-09-15 20:00:00 final 
#> 3   77744   2027            240      714 Saiso…     1 2026-09-15 20:15:00 final 
#> 4   77749   2027            240      714 Saiso…     1 2026-09-15 20:15:00 final 
#> 5   77747   2027            240      714 Saiso…     1 2026-09-15 20:30:00 final 
#> 6   77748   2027            240      714 Saiso…     1 2026-09-15 20:30:00 final 
#> # ℹ 14 more variables: decision <chr>, home_team_id <int>, home_team <chr>,
#> #   home_team_abbreviation <chr>, away_team_id <int>, away_team <chr>,
#> #   away_team_abbreviation <chr>, home_score <int>, away_score <int>,
#> #   home_team_participant_id <int>, away_team_participant_id <int>,
#> #   venue_id <int>, venue <chr>, game_label <chr>
# }