# NBA API: Get standings

> 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.

Unofficial. Not affiliated with or endorsed by NBA.

- Page: https://fous.com/methods/nba.com/get-standings
- Method: `nba.com/get_standings`, version 1
- Website: nba.com
- Returns: season, eastern_conference and western_conference teams with rank, record, streak, last 10, home/away records, games behind, clinch status and team page URL
- 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 |
|---|---|---|---|---|
| `season` | string | no | `"2024-25"` | NBA season, such as "2025-26" or its starting year "2025". Defaults to the season displayed on the NBA standings page. Default "". |

## Output

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

```json
{
  "season": "2024-25"
}
```

Its output:

```json
{
  "season": "2024-25",
  "eastern_conference": [
    {
      "rank": 1,
      "team": "Cleveland Cavaliers",
      "wins": 64,
      "losses": 18,
      "streak": "Lost 1",
      "last_10": "6-4",
      "page_url": "https://www.nba.com/team/1610612739/cavaliers",
      "away_record": "30-11",
      "home_record": "34-7",
      "games_behind": 0,
      "clinch_status": "Clinched Eastern Conference",
      "win_percentage": 0.78
    },
    {
      "rank": 2,
      "team": "Boston Celtics",
      "wins": 61,
      "losses": 21,
      "streak": "Won 2",
      "last_10": "8-2",
      "page_url": "https://www.nba.com/team/1610612738/celtics",
      "away_record": "33-8",
      "home_record": "28-13",
      "games_behind": 3,
      "clinch_status": "Clinched Atlantic Division",
      "win_percentage": 0.744
    },
    {
      "rank": 3,
      "team": "New York Knicks",
      "wins": 51,
      "losses": 31,
      "streak": "Won 1",
      "last_10": "6-4",
      "page_url": "https://www.nba.com/team/1610612752/knicks",
      "away_record": "24-17",
      "home_record": "27-14",
      "games_behind": 13,
      "clinch_status": "Clinched Playoff Berth",
      "win_percentage": 0.622
    }
  ],
  "western_conference": [
    {
      "rank": 1,
      "team": "Oklahoma City Thunder",
      "wins": 68,
      "losses": 14,
      "streak": "Won 4",
      "last_10": "8-2",
      "page_url": "https://www.nba.com/team/1610612760/thunder",
      "away_record": "32-8",
      "home_record": "35-6",
      "games_behind": 0,
      "clinch_status": "Clinched Western Conference",
      "win_percentage": 0.829
    },
    {
      "rank": 2,
      "team": "Houston Rockets",
      "wins": 52,
      "losses": 30,
      "streak": "Lost 3",
      "last_10": "6-4",
      "page_url": "https://www.nba.com/team/1610612745/rockets",
      "away_record": "23-17",
      "home_record": "29-12",
      "games_behind": 16,
      "clinch_status": "Clinched Southwest Division",
      "win_percentage": 0.634
    },
    {
      "rank": 3,
      "team": "Los Angeles Lakers",
      "wins": 50,
      "losses": 32,
      "streak": "Lost 1",
      "last_10": "6-4",
      "page_url": "https://www.nba.com/team/1610612747/lakers",
      "away_record": "19-22",
      "home_record": "31-10",
      "games_behind": 18,
      "clinch_status": "Clinched Pacific Division",
      "win_percentage": 0.61
    }
  ]
}
```

## 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":"nba.com/get_standings","input":{"season":"2024-25"}}'
```

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 current NBA standings for the Eastern Conference this season?
- Show me the 2024-25 Western Conference standings with each team's record and games behind.
- Which teams are on a winning streak in the NBA right now, and where do they rank in their conference?
- I need the 2023-24 NBA standings including home and away records and clinch status for every team on nba.com.
- Can you pull the NBA regular-season standings for 2025 in rank order, with last-10 records for each conference?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "season": {
      "type": "string",
      "default": "",
      "description": "NBA season, such as \"2025-26\" or its starting year \"2025\". Defaults to the season displayed on the NBA standings page."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "season",
    "eastern_conference",
    "western_conference"
  ],
  "properties": {
    "season": {
      "type": "string",
      "description": "Season shown in the standings."
    },
    "eastern_conference": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "team",
          "wins",
          "losses",
          "win_percentage",
          "games_behind",
          "streak",
          "last_10",
          "home_record",
          "away_record",
          "clinch_status",
          "page_url"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Team position in the conference."
          },
          "team": {
            "type": "string",
            "description": "Team name."
          },
          "wins": {
            "type": "integer",
            "description": "Games won."
          },
          "losses": {
            "type": "integer",
            "description": "Games lost."
          },
          "streak": {
            "type": [
              "string",
              "null"
            ],
            "description": "Current consecutive wins or losses."
          },
          "last_10": {
            "type": [
              "string",
              "null"
            ],
            "description": "Record in the last ten games."
          },
          "page_url": {
            "type": "string",
            "description": "NBA team page."
          },
          "away_record": {
            "type": [
              "string",
              "null"
            ],
            "description": "Away wins and losses."
          },
          "home_record": {
            "type": [
              "string",
              "null"
            ],
            "description": "Home wins and losses."
          },
          "games_behind": {
            "type": [
              "number",
              "null"
            ],
            "description": "Games behind the conference leader."
          },
          "clinch_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Clinch or elimination status when shown."
          },
          "win_percentage": {
            "type": "number",
            "description": "Fraction of games won."
          }
        },
        "additionalProperties": false
      },
      "description": "Eastern Conference teams in rank order."
    },
    "western_conference": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "team",
          "wins",
          "losses",
          "win_percentage",
          "games_behind",
          "streak",
          "last_10",
          "home_record",
          "away_record",
          "clinch_status",
          "page_url"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Team position in the conference."
          },
          "team": {
            "type": "string",
            "description": "Team name."
          },
          "wins": {
            "type": "integer",
            "description": "Games won."
          },
          "losses": {
            "type": "integer",
            "description": "Games lost."
          },
          "streak": {
            "type": [
              "string",
              "null"
            ],
            "description": "Current consecutive wins or losses."
          },
          "last_10": {
            "type": [
              "string",
              "null"
            ],
            "description": "Record in the last ten games."
          },
          "page_url": {
            "type": "string",
            "description": "NBA team page."
          },
          "away_record": {
            "type": [
              "string",
              "null"
            ],
            "description": "Away wins and losses."
          },
          "home_record": {
            "type": [
              "string",
              "null"
            ],
            "description": "Home wins and losses."
          },
          "games_behind": {
            "type": [
              "number",
              "null"
            ],
            "description": "Games behind the conference leader."
          },
          "clinch_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Clinch or elimination status when shown."
          },
          "win_percentage": {
            "type": "number",
            "description": "Fraction of games won."
          }
        },
        "additionalProperties": false
      },
      "description": "Western Conference teams in rank order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [NBA API: Get scores](https://fous.com/methods/nba.com/get-scores.md): Gets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue.
- [NBA API: Get box score](https://fous.com/methods/nba.com/get-box-score.md): Returns the NBA box score for a game between two teams on a date; without a date, their most recent matchup, including Summer League and games in progress.
- [NBA API: Get player by name](https://fous.com/methods/nba.com/get-player.md): Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career.
- [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.
- [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.
- [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.
- [NHL API: Get standings](https://fous.com/methods/nhl.com/get-standings.md): Gets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage.
- [Formula 1 API: Get championship standings](https://fous.com/methods/formula1.com/get-standings.md): Gets Formula 1 drivers' and teams' championship standings for a season, with the last completed race. Teams' standings begin in 1958.
- [All NBA methods](https://fous.com/methods/nba.com.md)