get_games

5 creditsStats + aggregationPOST /v1/get_games

Data refreshed Nov 9, 2026 · changelog

Query games by date range, team, season, game state, or type.

Use it when you're building a dataset for analysis: pull all games from a date range, all playoff games for a team, or all final scores from last season. This is the workhorse endpoint for model training data.

Parameters

date_fromstringoptional: Start date (YYYY-MM-DD)
date_tostringoptional: End date (YYYY-MM-DD)
teamstringoptional: Team abbreviation
seasonstringoptional: Season (e.g. "20252026")
game_statestringoptional: FUT, LIVE, FINAL, or OFF
game_typestringoptional: regular, playoff, or preseason
limitintegeroptional: Max results (1-500, default 100)
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_games 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_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "TOR",
  "date_from": "2026-03-01",
  "date_to": "2026-03-07",
  "game_state": "FINAL"
}'

Response

json

{
  "games": [
    {
      "id": "2025020934",
      "season": "20252026",
      "gameDate": "2026-03-02",
      "startTime": "19:00:00",
      "homeTeam": "TOR",
      "awayTeam": "BOS",
      "homeScore": 4,
      "awayScore": 2,
      "gameState": "FINAL",
      "gameType": "regular",
      "venue": "Scotiabank Arena"
    },
    {
      "id": "2025020958",
      "season": "20252026",
      "gameDate": "2026-03-05",
      "startTime": "19:30:00",
      "homeTeam": "MTL",
      "awayTeam": "TOR",
      "homeScore": 1,
      "awayScore": 3,
      "gameState": "FINAL",
      "gameType": "regular",
      "venue": "Bell Centre"
    }
  ]
}