Skip to content

get_schedule

2 creditsBasic lookupPOST /v1/get_schedule

Data refreshed · changelog

Upcoming games for the next N days. Defaults to 7 days.

Use it when you want to know what games are coming up this week: for a specific team or across the league. Useful for building game-day alerts or planning which games to watch.

Parameters

teamstringoptional
Team abbreviation (e.g. "BUF")
daysintegeroptional
Days ahead (1-30, default 7)
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_schedule itself. Point any MCP client at https://mcp.puckapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 2 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_schedule \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "BUF",
  "days": 7
}'

Response

json
{
  "games": [
    {
      "id": "2025021143",
      "gameDate": "2026-04-10",
      "startTime": "19:00:00",
      "homeTeam": "BUF",
      "awayTeam": "TOR",
      "homeTeamName": "Buffalo Sabres",
      "awayTeamName": "Toronto Maple Leafs",
      "venue": "KeyBank Center",
      "gameType": "regular"
    },
    {
      "id": "2025021187",
      "gameDate": "2026-04-12",
      "startTime": "19:30:00",
      "homeTeam": "FLA",
      "awayTeam": "BUF",
      "homeTeamName": "Florida Panthers",
      "awayTeamName": "Buffalo Sabres",
      "venue": "Amerant Bank Arena",
      "gameType": "regular"
    }
  ]
}

Response fields

games[].idstring
Unique game ID
games[].gameDatestring
Date (YYYY-MM-DD)
games[].startTimestring
Start time (HH:MM:SS)
games[].homeTeamstring
Home team abbreviation
games[].awayTeamstring
Away team abbreviation
games[].homeTeamNamestring
Home team full name
games[].awayTeamNamestring
Away team full name
games[].venuestring
Arena name
games[].gameTypestring
regular, playoff, or preseason

Related endpoints

Try it

500 free credits every month: 250 calls to get_schedule, and no card.