agent-data
Start free
Catalog / NHL

NHL API

nhl.com

Live, read-only access to NHL schedules, scores, standings, team rosters, and player landing data. Career totals and featured stats are null when NHL's public player response omits those fields.

  • Sports
  • NHL
  • hockey
  • schedules
  • scores
  • standings
  • rosters
Connect your agent Call over HTTP
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the NHL API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Return NHL game-week records and the adjacent source start dates for a date or the current schedule window.

Optional parameters 1

Calendar date in YYYY-MM-DD form; omit to request the NHL current schedule.

View call pricing
cURL · Schedule
curl --request GET --get 'https://api.agent-data.dev/nhl-com/v1/schedule' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETSchedule/v1/schedule

Return NHL game-week records and the adjacent source start dates for a date or the current schedule window.

Input

dateOptionalQuery · string (date) | null

Calendar date in YYYY-MM-DD form; omit to request the NHL current schedule.

Example: 2026-09-22

Response

gameWeekobject[]
gameWeek[].datestring
gameWeek[].gamesobject[]
gameWeek[].dayAbbrevstring
gameWeek[].numberOfGamesinteger
transportstring
nextStartDatestring
previousStartDatestring
GETScores/v1/scores

Return all game records and NHL's previous, current, and next dates for a date or the current scores window.

Input

dateOptionalQuery · string (date) | null

Calendar date in YYYY-MM-DD form; omit to request the NHL current scores window.

Example: 2026-09-22

Response

gamesobject[]
nextDatestring
prevDatestring
transportstring
currentDatestring
GETStandings/v1/standings

Return the complete NHL standings array for a date, or the latest standings snapshot when date is omitted.

Input

dateOptionalQuery · string (date) | null

Calendar date in YYYY-MM-DD form; omit to request NHL's latest standings snapshot.

Example: 2025-12-01

Response

standingsobject[]
standings[].winsinteger
standings[].lossesinteger
standings[].pointsinteger
standings[].otLossesinteger
standings[].teamNameobject
standings[].teamName.defaultstring
standings[].teamAbbrevobject
standings[].teamAbbrev.defaultstring
standings[].gamesPlayedinteger
transportstring
GETRoster by team/v1/roster/{team}

Return goalies, forwards, and defensemen for a three-letter team abbreviation and optional eight-digit season identifier.

Input

teamRequiredPath · string

Three-letter uppercase NHL team abbreviation.

Example: BUF

seasonOptionalQuery · string | null

Optional NHL season identifier in YYYYYYYY form; omit for the source's current season.

Example: 20252026

Response

goaliesobject[]
goalies[].idinteger
goalies[].lastNameobject
goalies[].lastName.defaultstring
goalies[].firstNameobject
goalies[].firstName.defaultstring
goalies[].positionCode"C" | "L" | "R" | "D" | "G"
forwardsobject[]
forwards[].idinteger
forwards[].lastNameobject
forwards[].lastName.defaultstring
forwards[].firstNameobject
forwards[].firstName.defaultstring
forwards[].positionCode"C" | "L" | "R" | "D" | "G"
transportstring
defensemenobject[]
defensemen[].idinteger
defensemen[].lastNameobject
defensemen[].lastName.defaultstring
defensemen[].firstNameobject
defensemen[].firstName.defaultstring
defensemen[].positionCode"C" | "L" | "R" | "D" | "G"
GETPlayer landing by player id/v1/player/{player_id}/landing

Return the requested NHL player name, position, career totals, featured stats, and current team abbreviation. Source-omitted stats are null.

Input

player_idRequiredPath · integer

Positive NHL player ID.

Example: 8477497

Response

lastNameobject
lastName.defaultstring
position"C" | "L" | "R" | "D" | "G"
firstNameobject
firstName.defaultstring
transportstring
careerTotalsobject | null
featuredStatsobject | null
currentTeamAbbrevstring | null

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.