Skip to content

get_player_stats

5 creditsStats + aggregationPOST /v1/get_player_stats

Data refreshed · changelog

Player bio and goalie stats (if goalie). For skaters, returns bio info and team context.

Use it when you have a player ID (from search_players) and want their full profile: bio, team, position, and for goalies, their complete stat line including GSAX and advanced metrics.

Parameters

player_idintegerrequired
Player ID (from search_players)
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_stats 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_stats \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": 8480045
}'

Response

json
{
  "player": {
    "id": 8480045,
    "name": "Ukko-Pekka Luukkonen",
    "team": "BUF",
    "teamName": "Buffalo Sabres",
    "position": "G",
    "jerseyNumber": 1,
    "birthDate": "1999-03-09",
    "birthCountry": "FIN",
    "heightInches": 77,
    "weightLbs": 220,
    "shootsCatches": "L"
  },
  "goalie_stats": {
    "gamesPlayed": 55,
    "gamesStarted": 55,
    "wins": 31,
    "losses": 18,
    "otLosses": 4,
    "savePct": 0.908,
    "gaa": 2.71,
    "gsax": 25,
    "shutouts": 2,
    "expectedGoalsAgainst": 171,
    "highDangerSavePct": 0.895,
    "rollingSavePct": 0.945,
    "rollingGsax": 7,
    "trend": "stable",
    "restDays": 3
  }
}

Response fields

player.idinteger
Player ID
player.namestring
Full name
player.teamstring
Team abbreviation
player.teamNamestring
Full team name
player.positionstring
Position code
player.jerseyNumberinteger
Jersey number
player.birthDatestring
Birth date
player.birthCountrystring
Birth country
player.heightInchesinteger
Height in inches
player.weightLbsinteger
Weight in pounds
player.shootsCatchesstring
Shoots/catches (L or R)
goalie_statsobject|null
Goalie stats (null for skaters)
goalie_stats.savePctnumber
Save percentage
goalie_stats.gaanumber
Goals against average
goalie_stats.gsaxnumber
Goals saved above expected

Related endpoints

Try it

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