Skip to content

get_standings

2 creditsBasic lookupPOST /v1/get_standings

Standings from every final game: overall, conference, home, away, last 10

Use it when you want a season's standings computed from every final game: overall, conference, home, away, margin and last 10.

Parameters

seasonnumber | stringoptional
Season by the year it ends (default: the latest).
leagueenum: nba | wnba | ncaam | ncaaw | nbloptional
League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw, nbl.

Notes

  • Over MCP, ask for it in plain English and the client calls get_standings itself. Point any MCP client at https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 2 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.dunkapi.com/v1/get_standings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2026
}'

Response

json
{
  "season": 2026,
  "standings": [
    {
      "team_id": "25",
      "abbrev": "OKC",
      "display_name": "Oklahoma City Thunder",
      "conference": "Western",
      "wins": 64,
      "losses": 18,
      "conf_wins": 41,
      "conf_losses": 11,
      "home_wins": 34,
      "home_losses": 8,
      "away_wins": 30,
      "away_losses": 10,
      "points_for": 119,
      "points_against": 107.9,
      "avg_margin": 11.1,
      "last10_wins": 7,
      "win_pct": 0.78
    },
    {
      "team_id": "24",
      "abbrev": "SA",
      "display_name": "San Antonio Spurs",
      "conference": "Western",
      "wins": 62,
      "losses": 20,
      "conf_wins": 36,
      "conf_losses": 16,
      "home_wins": 32,
      "home_losses": 8,
      "away_wins": 30,
      "away_losses": 12,
      "points_for": 119.8,
      "points_against": 111.5,
      "avg_margin": 8.3,
      "last10_wins": 8,
      "win_pct": 0.756
    },
    {
      "team_id": "8",
      "abbrev": "DET",
      "display_name": "Detroit Pistons",
      "conference": "Eastern",
      "wins": 60,
      "losses": 22,
      "conf_wins": 39,
      "conf_losses": 13,
      "home_wins": 32,
      "home_losses": 9,
      "away_wins": 28,
      "away_losses": 13,
      "points_for": 117.8,
      "points_against": 109.6,
      "avg_margin": 8.2,
      "last10_wins": 8,
      "win_pct": 0.732
    }
  ],
  "count": 30,
  "note": "Regular season, final games only. conference is the team's current conference."
}

Response fields

seasonnumber
standings[]array
List of objects
standings[].team_idstring
standings[].abbrevstring
standings[].display_namestring
standings[].conferencestring
standings[].winsnumber
standings[].lossesnumber
standings[].conf_winsnumber
standings[].conf_lossesnumber
standings[].home_winsnumber
standings[].home_lossesnumber
standings[].away_winsnumber
standings[].away_lossesnumber
standings[].points_fornumber
standings[].points_againstnumber
standings[].avg_marginnumber
standings[].last10_winsnumber
standings[].win_pctnumber
countnumber
notestring

Used in

Related endpoints

Try it

500 free credits every month: 250 calls to get_standings, and no card.