canonical: https://jentic.com/apis/nhle.com/nhle

# Nhle NHL API

Unofficial NHL API providing programmatic access to live game scores, team standings, player statistics, schedules, and playoff series data from the National Hockey League. Supports real-time score tracking, historical season data lookups, and skater statistics leaders across multiple categories. The API covers all NHL teams with endpoints for current games, historical data, and playoff series.

## For AI agents

Retrieve NHL game scores, schedules, team standings, player statistics, and league information. Supports both current and historical season data queries.

## Scope

Does not handle ticket sales, merchandise, fantasy league management, or live video streaming - use for read-only access to NHL scores, schedules, standings, and statistics only.

## Capabilities

- Retrieve current and historical NHL game scores with team details and venue information
- Query game schedules by specific date or retrieve current schedule
- Access season standings with team records, points, and conference/division breakdowns
- Look up skater statistics leaders for specific categories across current or historical seasons
- Retrieve playoff series schedules by season and series identifier
- Access player spotlight information including team affiliation and position
- Query season metadata including regular season and playoff date ranges

## Use cases

### Sports App Real-Time Score Integration

Build sports applications that display live NHL scores, game schedules, and team standings. The API provides current game data via the `/v1/score/now` endpoint, returning team scores, game states, and venue information. Applications can refresh scores every few seconds during active games to provide near-real-time updates without managing complex websocket connections or parsing HTML from league websites.

Example prompt: Retrieve current NHL game scores and filter for games in progress, returning team names, current scores, and game state

### Fantasy Sports Statistics Dashboard

Power fantasy hockey platforms with real-time player statistics and league leaders. The API exposes skater statistics leaders via `/v1/skater-stats-leaders/current` with support for filtering by multiple stat categories (goals, assists, points, plus-minus). Fantasy apps can rank players, calculate point values, and update rosters based on current season performance without maintaining a local statistics database.

Example prompt: Retrieve the top 20 skater statistics leaders in goals, assists, and points for the current season and return their names, teams, and stat values

### Sports Analytics Historical Data Research

Analyze historical NHL data for trends, predictions, and statistical modeling. The API provides access to past season schedules, scores, and standings through date-specific endpoints. Researchers can query game outcomes by date, analyze playoff series progressions, and study team performance across multiple seasons. Data is returned in structured JSON format ready for statistical analysis tools.

Example prompt: Retrieve all game scores for the 2023 Stanley Cup Finals playoff series and calculate win percentages for each team

### AI Agent Sports Information Assistant

Enable AI agents to answer natural language questions about NHL games, standings, and player performance through Jentic. Agents search Jentic for NHL data operations (search for 'get NHL standings'), load the schema, and execute queries to retrieve structured league data. Integration through Jentic eliminates the need to parse unofficial API documentation or handle endpoint discovery manually.

Example prompt: Search Jentic for NHL standings operation, load the schema, execute the query to retrieve current Eastern Conference standings, and format the top 5 teams by points

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/score/now` | Get current NHL game scores |
| GET | `/v1/score/{date}` | Get scores for a specific date |
| GET | `/v1/standings-season` | Get current season standings |
| GET | `/v1/schedule/now` | Get current game schedule |
| GET | `/v1/schedule/{date}` | Get schedule for a specific date |
| GET | `/v1/skater-stats-leaders/current` | Get current skater statistics leaders |
| GET | `/v1/player-spotlight` | Get player spotlight information |
| GET | `/v1/season` | Get season metadata |

## Key resources

- **Schedules** — Retrieve game schedules for current, specific dates, or playoff series
- **Scores** — Access current and historical game scores with team and venue details
- **Standings** — Query season standings with team records and point totals
- **Players** — Get player spotlights and statistics leaders by category
- **General** — Access season information, location data, and streaming availability

## Why Jentic

- **Setup:** Wiring the NHL API by hand means learning its date-based paths on api-web.nhle.com and building score, schedule, standings, and stats requests yourself, even though it needs no authentication. Through Jentic you install once, import the NHL API from the API Directory, and your agent calls it alongside your other integrations.
- **Permission scoping:** The NHL API is read-only and puts the date in the URL path (`/score/{date}`, `/schedule/{date}`), so scope your agent to the operations it needs, such as reading scores and standings, while leaving schedule or player-spotlight lookups out of the allowed set unless you add them.
- **Credential handling:** The NHL API requires no credential, so there is none to store, and Jentic One gives your agent one consistent interface for public and authenticated APIs without tracking which is which. No secret enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get NHL standings' or 'retrieve hockey scores' and Jentic returns the matching NHL API operation with its input schema so the agent calls the right endpoint without parsing the /v1 path structure or reference docs.

## Related APIs

- **NBA Stats API** — Basketball equivalent providing NBA game scores, player statistics, and team standings
- **SportsData.io NFL API** — Commercial sports data platform with NFL coverage including scores, standings, and player stats
- **TheSportsDB API** — Multi-sport database covering NHL plus 40+ other sports with team rosters, league data, and historical records

## FAQ

### What authentication does the NHL API use?

The NHL API does not require authentication. All endpoints are publicly accessible without API keys or OAuth tokens. Jentic handles the API calls through its unified interface, so agents can query NHL data using natural language search without managing authentication flows.

### Can I retrieve historical NHL game scores with the NHL API?

Yes, the NHL API supports historical game score queries via the GET `/v1/score/{date}` endpoint. Pass a date in YYYY-MM-DD format to retrieve all game scores for that specific day. Through Jentic, agents search for 'get NHL scores by date', load the schema, and execute the query with the desired date parameter.

### What are the rate limits for the NHL API?

The NHL API does not publish official rate limits in its documentation. Based on community usage, the API is intended for moderate use and may throttle excessive requests. When integrating through Jentic, agents make targeted queries based on specific intents rather than bulk scraping, which helps stay within reasonable usage boundaries.

### How do I get current NHL standings through Jentic?

Search Jentic for 'get NHL standings', which returns the GET `/v1/standings-season` operation. Load the schema to see the response structure, then execute the operation. The API returns an array of standing entries with team records, points, conference and division assignments, and point percentages. Install the Jentic SDK with pip install jentic and authenticate through Jentic One, the self-hosted execution layer.

### Can I filter skater statistics leaders by specific categories?

Yes, the GET `/v1/skater-stats-leaders/current` endpoint accepts a categories query parameter with comma-separated stat categories (goals, assists, points, plusMinus, etc.) and a limit parameter for the number of leaders to return. Through Jentic, search for 'get NHL skater stats leaders', load the schema to see available categories, and execute with your desired filters.

### Is the NHL API free to use?

Yes, the NHL API is free to use. There are no subscription tiers or usage fees. The API is unofficial and provided without commercial support from the NHL. Access is subject to reasonable usage patterns to avoid service disruption.

### Can I limit what my agent is allowed to do with the NHL API?

Yes. Because Jentic One is self-hosted, your own rules decide which NHL API operations your agent may call, and the API is read-only so there is nothing to write. You can allow just the operations you need, such as reading scores from GET `/v1/score/now` and GET `/v1/score/{date}` and standings from GET `/v1/standings-season`, while leaving schedule lookups (GET `/v1/schedule/{date}`) and player-spotlight or skater-stats-leaders calls out of the allowed set. The NHL API needs no credential, so scoping is purely about which endpoints the agent is permitted to reach.