---
title: "Skater season stats"
method: POST
path: "/v1/get_skater_season_stats"
tags: ["Stats + aggregation"]
---

# Skater season stats

`POST /v1/get_skater_season_stats`

## Request

- Base URL: `https://mcp.puckapi.com`
- URL: `https://mcp.puckapi.com/v1/get_skater_season_stats`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use when ranking skaters or comparing scoring. Returns a leaderboard sorted by points, goals, assists, plus/minus, or shots, with a games-played filter. Includes power play and shorthanded production, shooting%, faceoff%, and average time on ice. Seasons from 2010-11 on. Costs 5 credits.

## Request body

- object
  - `team` string: Filter by team abbreviation
  - `season` string: Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to the most recent season with stats, which is the current season once it is under way and the previous one before that. The season actually used is echoed in filters.season.
  - `min_games` integer: Minimum games played (default 10; early in a season, half the most games anyone has played so far)
  - `sort_by` 'points' | 'goals' | 'assists' | 'plus_minus' | 'shots': Sort metric (default points)
  - `limit` integer: Max results (default 20)
  - `league` 'nhl' | 'pwhl' | 'ohl' | 'whl' | 'qmjhl' | 'echl' | 'ahl' | 'ushl': League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `skaters` object[], required
      - `playerId` number, required
      - `playerName` string, required
      - `team` string, nullable, required
      - `teamName` string, nullable, required
      - `position` string, nullable, required
      - `gamesPlayed` number, nullable, required
      - `goals` number, nullable, required
      - `assists` number, nullable, required
      - `points` number, nullable, required
      - `plusMinus` number, nullable, required
      - `pim` number, nullable, required
      - `powerPlayGoals` number, nullable, required
      - `powerPlayPoints` number, nullable, required
      - `shorthandedGoals` number, nullable, required
      - `shorthandedPoints` number, nullable, required
      - `gameWinningGoals` number, nullable, required
      - `otGoals` number, nullable, required
      - `shots` number, nullable, required
      - `shootingPct` number, nullable, required
      - `faceoffPct` number, nullable, required
      - `avgToiPerGame` number, nullable, required
      - `snapshotDate` string, nullable, required
    - `count` number, required
    - `filters` object, required
      - `season` string, nullable, required
      - `min_games` number, required
      - `sort_by` string, required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/puckapi/apis/puckapi-api.md) · [All operations](https://skmtc.dev/puckapi/apis/puckapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puckapi/apis/puckapi-api/revisions/99b3e5171ab4?raw)