NHL Records and Stats

About NHL Records and Stats

This project documents the publicly accessible endpoints of the NHL's API, covering both the records API (records.nhl.com) and the stats API, including a newer 2023 version. Documentation is maintained by hand in markdown files alongside a Swagger/OpenAPI 3 specification, and includes supplementary material such as team logo SVG resources and related NHL API trivia.

It is aimed at developers and stats enthusiasts who want to query NHL data programmatically but lack official documentation from the league. The repository also links to a collection of projects built using this documentation, contributed by other developers.

The project is maintained by a single individual who accepts merge requests for missing or incorrect information. It is licensed under MIT and hosted on GitLab, with a companion GitLab Pages site.

Key features

• Documentation for the NHL Records API (records.nhl.com)
• Documentation for the NHL Stats API, including the new 2023 API
• OpenAPI 3 (Swagger) spec for the NHL API
• Team logos as scalable SVGs for all teams and franchises back to 1917
• Python script (wadl-map.py) that auto-parses the NHL's application.wadl into JSON

Frequently asked questions