Discontinued

This API no longer responds. Our last check on 2026-07-31 found no working endpoint — the service appears to have shut down or moved. The documentation, code samples and score below are kept for reference only; do not build against this API. See working Sports & Fitness APIs →

Overview

NHL Records and Stats is a free, open API that provides historical NHL data including player records, season stats, team standings, and game details. No API key is required, so you can start exploring hockey data immediately. It is well-documented on GitLab with community-maintained endpoint references.

Beginner Tip

The NHL API is unofficial and undocumented by the NHL itself, but the community GitLab page lists all known endpoints. Start with /api/v1/teams to get a list of all teams before drilling into specific data.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

NHL Records and Stats data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "match_id": 4521,
  "home_team": "Team A",
  "away_team": "Team B",
  "score": {
    "home": 2,
    "away": 1
  },
  "status": "Full Time",
  "date": "2025-01-15",
  "league": "Premier League"
}

Field Reference

teams[].id Unique NHL team identifier
teams[].name Full team name, e.g. Toronto Maple Leafs
teams[].abbreviation Three-letter team abbreviation, e.g. TOR
teams[].division.name Name of the division the team belongs to
teams[].venue.name Name of the team home arena

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://statsapi.web.nhl.com/api/v1/teams";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

404 Not Found Team ID or player ID does not exist
Fetch /api/v1/teams first to get valid team IDs, then use those IDs in further requests
Unexpected null fields Some historical records lack complete data
Always check for null values before accessing nested fields like roster or stats
Slow or timeout response Requesting large datasets like full season schedules
Add query parameters such as startDate and endDate to limit the response size

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Sports & Fitness
Difficulty Beginner
Listing details not endpoint-verified

Similar APIs

View All →