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

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": 2024
}'

Response

json
{
  "season": 2024,
  "standings": [
    {
      "team_id": "2",
      "abbrev": "BOS",
      "display_name": "Boston Celtics",
      "conference": "Eastern",
      "wins": 64,
      "losses": 18,
      "conf_wins": 0,
      "conf_losses": 0,
      "home_wins": 37,
      "home_losses": 4,
      "away_wins": 27,
      "away_losses": 14,
      "points_for": 120.6,
      "points_against": 109.2,
      "avg_margin": 11.3,
      "last10_wins": 7,
      "win_pct": 0.78
    },
    {
      "team_id": "25",
      "abbrev": "OKC",
      "display_name": "Oklahoma City Thunder",
      "conference": "Western",
      "wins": 57,
      "losses": 25,
      "conf_wins": 0,
      "conf_losses": 0,
      "home_wins": 33,
      "home_losses": 8,
      "away_wins": 24,
      "away_losses": 17,
      "points_for": 120.1,
      "points_against": 112.7,
      "avg_margin": 7.4,
      "last10_wins": 7,
      "win_pct": 0.695
    },
    {
      "team_id": "7",
      "abbrev": "DEN",
      "display_name": "Denver Nuggets",
      "conference": "Western",
      "wins": 57,
      "losses": 25,
      "conf_wins": 0,
      "conf_losses": 0,
      "home_wins": 33,
      "home_losses": 8,
      "away_wins": 24,
      "away_losses": 17,
      "points_for": 114.9,
      "points_against": 109.6,
      "avg_margin": 5.3,
      "last10_wins": 6,
      "win_pct": 0.695
    }
  ],
  "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

Related endpoints

Try it

500 credits free on signup: 250 calls to get_standings, and no card.