Skip to content

get_player_game_log

5 creditsStats + aggregationPOST /v1/get_player_game_log

A player's game-by-game stat lines for a season: date, opponent, home/away, and the box score for each game.

Use it when you want how a player did game by game: a hot streak, a slump, a home/road split: rather than a season total. Use get_player_stats or get_skater_season_stats/get_goalie_stats for the season line.

Parameters

player_idintegerrequired
NHL player ID
seasonstringoptional
Season (e.g. "20252026"). Defaults to the most recent season with stats for this player.
game_typestringoptional
regular, playoff, preseason, or all (default regular)
limitintegeroptional
Max games to return (1-200, default 100)
offsetintegeroptional
Pagination offset
leagueenum: nhl | pwhl | ohl | whl | qmjhl | echl | ahl | ushloptional
League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

Notes

  • Over MCP, ask for it in plain English and the client calls get_player_game_log itself. Point any MCP client at https://mcp.puckapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.puckapi.com/v1/get_player_game_log \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": 8478402,
  "season": "20242025",
  "limit": 2
}'

Response

json
{
  "player": {
    "id": 8478402,
    "name": "Connor McDavid",
    "position": "C"
  },
  "games": [
    {
      "gameId": "2024020008",
      "gameDate": "2024-10-09",
      "gameType": "regular",
      "team": "EDM",
      "opponent": "WPG",
      "homeAway": "home",
      "goals": 0,
      "assists": 0,
      "points": 0,
      "shots": 0,
      "pim": 0,
      "ppPoints": 0,
      "plusMinus": -2,
      "decision": null,
      "shotsAgainst": null,
      "saves": null,
      "goalsAgainst": null,
      "savePct": null,
      "timeOnIce": 1249
    },
    {
      "gameId": "2024020036",
      "gameDate": "2024-10-12",
      "gameType": "regular",
      "team": "EDM",
      "opponent": "CHI",
      "homeAway": "home",
      "goals": 0,
      "assists": 1,
      "points": 1,
      "shots": 3,
      "pim": 2,
      "ppPoints": 1,
      "plusMinus": -1,
      "decision": null,
      "shotsAgainst": null,
      "saves": null,
      "goalsAgainst": null,
      "savePct": null,
      "timeOnIce": 1412
    }
  ],
  "count": 2,
  "season": "20242025",
  "game_type": "regular",
  "note": "time_on_ice (seconds) and plus_minus are the official NHL boxscore figures, loaded with each game's shift chart (2010-11 on); a game not loaded yet shows null. get_shifts has the shifts and get_situation_time the time at each strength. pp_points is inferred from the strength state recorded on each scoring play and may be off by a point or two from the official season total.",
  "next_offset": null
}

Response fields

playerobject
Player id, name and position
games[].gameIdstring
NHL game ID
games[].gameDatestring
Date the game was played
games[].gameTypestring
regular, playoff or preseason
games[].teamstring
The player's team in that game
games[].opponentstring
The opposing team
games[].homeAwaystring
home or away
games[].goalsinteger
Skaters only. Null for goalies
games[].assistsinteger
Skaters only. Null for goalies
games[].pointsinteger
Skaters only. Null for goalies
games[].shotsinteger
Shots on goal. Skaters only
games[].piminteger
Penalty minutes. Skaters only
games[].ppPointsinteger
Power-play goals plus assists, inferred from strength state. Skaters only; null where strength state is not recorded (PWHL)
games[].plusMinusinteger
Skaters, NHL only: the official boxscore plus/minus, from 2010-11 on. Null for goalies, other leagues, and a game whose shift chart is not loaded yet
games[].decisionstring
Goalies only: win or loss, reflecting the team's result in that game
games[].shotsAgainstinteger
Goalies only
games[].savesinteger
Goalies only
games[].goalsAgainstinteger
Goalies only
games[].savePctnumber
Goalies only, 0-1 scale
games[].timeOnIceinteger
Seconds on ice, the official boxscore figure (NHL, 2010-11 on). Other leagues: goalies' starts only, null for skaters
countinteger
Games returned on this page
seasonstring
The season actually used
game_typestring
The game_type actually used
notestring
What this tool cannot compute and why, in plain language
next_offsetinteger
Pass as offset for the next page, or null when done

Used in

Related endpoints

Try it

500 free credits every month: 100 calls to get_player_game_log, and no card.