# NHL API: Get standings

> Gets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage.

Unofficial. Not affiliated with or endorsed by NHL.

- Page: https://fous.com/methods/nhl.com/get-standings
- Method: `nhl.com/get_standings`, version 1
- Website: nhl.com
- Returns: conference, division, ranks, record, points, goals, streak and team page for each team
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `date` | string | no | `"2025-12-01"` | Standings date in YYYY-MM-DD; defaults to today. Example: 2025-12-01. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "date": "2025-12-01"
}
```

Its output:

```json
{
  "date": "2025-12-01",
  "teams": [
    {
      "team": "Tampa Bay Lightning",
      "wins": 16,
      "losses": 7,
      "points": 34,
      "division": "Atlantic",
      "page_url": "https://www.nhl.com/lightning",
      "goals_for": 84,
      "conference": "Eastern",
      "league_rank": 3,
      "games_played": 25,
      "division_rank": 1,
      "goals_against": 65,
      "current_streak": "Won 7",
      "conference_rank": 1,
      "goal_difference": 19,
      "overtime_losses": 2,
      "points_percentage": 0.68
    },
    {
      "team": "Boston Bruins",
      "wins": 15,
      "losses": 12,
      "points": 30,
      "division": "Atlantic",
      "page_url": "https://www.nhl.com/bruins",
      "goals_for": 83,
      "conference": "Eastern",
      "league_rank": 13,
      "games_played": 27,
      "division_rank": 2,
      "goals_against": 86,
      "current_streak": "Won 1",
      "conference_rank": 7,
      "goal_difference": -3,
      "overtime_losses": 0,
      "points_percentage": 0.555556
    },
    {
      "team": "Montréal Canadiens",
      "wins": 13,
      "losses": 8,
      "points": 29,
      "division": "Atlantic",
      "page_url": "https://www.nhl.com/canadiens",
      "goals_for": 82,
      "conference": "Eastern",
      "league_rank": 14,
      "games_played": 24,
      "division_rank": 3,
      "goals_against": 87,
      "current_streak": "Lost 1",
      "conference_rank": 8,
      "goal_difference": -5,
      "overtime_losses": 3,
      "points_percentage": 0.604167
    }
  ],
  "message": null
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"nhl.com/get_standings","input":{"date":"2025-12-01"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the NHL standings as of December 1, 2025, broken down by conference and division?
- Show me the league table for 2025-11-15 with each team's points, goals and current streak.
- Can you pull up the NHL standings from nhl.com for March 3, 2025?
- I need the division rankings and team homepages for the NHL standings on 2025-01-20.
- Which teams led the Western Conference in points on 2024-12-10, and what were their records?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Standings date in YYYY-MM-DD; defaults to today. Example: 2025-12-01."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "date",
    "teams",
    "message"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Requested standings date."
    },
    "teams": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "conference",
          "division",
          "division_rank",
          "conference_rank",
          "league_rank",
          "team",
          "games_played",
          "wins",
          "losses",
          "overtime_losses",
          "points",
          "points_percentage",
          "goals_for",
          "goals_against",
          "goal_difference",
          "current_streak",
          "page_url"
        ],
        "properties": {
          "team": {
            "type": "string",
            "description": "Team name."
          },
          "wins": {
            "type": "integer",
            "description": "Wins."
          },
          "losses": {
            "type": "integer",
            "description": "Regulation losses."
          },
          "points": {
            "type": "integer",
            "description": "Standings points."
          },
          "division": {
            "type": [
              "string",
              "null"
            ],
            "description": "Division name."
          },
          "page_url": {
            "type": "string",
            "format": "uri",
            "description": "Official team page, or standings page when no team page is listed."
          },
          "goals_for": {
            "type": "integer",
            "description": "Goals scored."
          },
          "conference": {
            "type": [
              "string",
              "null"
            ],
            "description": "Conference name."
          },
          "league_rank": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Rank in league."
          },
          "games_played": {
            "type": "integer",
            "description": "Games played."
          },
          "division_rank": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Rank in division."
          },
          "goals_against": {
            "type": "integer",
            "description": "Goals allowed."
          },
          "current_streak": {
            "type": [
              "string",
              "null"
            ],
            "description": "Current winning or losing streak in words."
          },
          "conference_rank": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Rank in conference."
          },
          "goal_difference": {
            "type": "integer",
            "description": "Goals scored minus goals allowed."
          },
          "overtime_losses": {
            "type": "integer",
            "description": "Overtime losses."
          },
          "points_percentage": {
            "type": [
              "number",
              "null"
            ],
            "description": "Share of possible standings points, from 0 to 1."
          }
        },
        "additionalProperties": false
      },
      "description": "Teams ordered by conference, division, and division rank."
    },
    "message": {
      "type": [
        "string",
        "null"
      ],
      "description": "Explains when there are no standings for the date."
    }
  },
  "additionalProperties": false
}
```

## See more

- [NHL API: Get scores](https://fous.com/methods/nhl.com/get-scores.md): Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks.
- [NHL API: Get player stats](https://fous.com/methods/nhl.com/get-player-stats.md): Looks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
- [NBA API: Get standings](https://fous.com/methods/nba.com/get-standings.md): Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page.
- [NFL API: Get standings](https://fous.com/methods/nfl.com/get-standings.md): Gets NFL regular-season standings by conference and division for a season, with clinch status when shown.
- [Yahoo API: Get team standings](https://fous.com/methods/sports.yahoo.com/get-standings.md): Returns Yahoo Sports team standings for a league and season, grouped by division or conference.
- [MLB API: Get standings](https://fous.com/methods/mlb.com/get-standings.md): Returns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year.
- [NFL API: Get scores](https://fous.com/methods/nfl.com/get-scores.md): Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
- [NCAA API: Get scores](https://fous.com/methods/ncaa.com/get-scores.md): Gets NCAA college sports games for a date (or, for football, the week containing it) with scores, rankings, live status, TV networks and NCAA game links, optionally for one conference.
- [All NHL methods](https://fous.com/methods/nhl.com.md)