Skip to content

get_game

5 creditsStats + aggregationPOST /v1/get_game

One game: both box scores, every player's line, each book's line, win probability

Use it when you need one game in full: both box scores, every player's line, each book's opening and closing line, and the win-probability range.

Parameters

game_idstringrequired
ESPN game id, from list_games or get_schedule.

Notes

  • Over MCP, ask for it in plain English and the client calls get_game itself. Point any MCP client at https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 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_game \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401585601"
}'

Response

json
{
  "game": {
    "game_id": "401585601",
    "season": 2024,
    "season_type": "regular",
    "date": "2024-03-16",
    "starts_at": "2024-03-17T00:30:00.000Z",
    "status": "final",
    "home": {
      "team_id": "13",
      "abbrev": "LAL",
      "name": "Los Angeles Lakers",
      "score": 121
    },
    "away": {
      "team_id": "9",
      "abbrev": "GS",
      "name": "Golden State Warriors",
      "score": 128
    },
    "periods": 4,
    "overtime_periods": 0,
    "neutral_site": false,
    "conference_game": false,
    "venue": "crypto.com Arena",
    "city": "Los Angeles",
    "attendance": 18997
  },
  "team_stats": [
    {
      "team_id": "9",
      "abbrev": "GS",
      "home": false,
      "pts": 128,
      "fgm": 51,
      "fga": 97,
      "tpm": 14,
      "tpa": 34,
      "ftm": 12,
      "fta": 15,
      "oreb": 14,
      "dreb": 31,
      "reb": 45,
      "ast": 38,
      "stl": 3,
      "blk": 4,
      "tov": 7,
      "pf": 19,
      "fast_break_pts": 9,
      "paint_pts": 62,
      "points_off_turnovers": 7,
      "largest_lead": 12
    },
    {
      "team_id": "13",
      "abbrev": "LAL",
      "home": true,
      "pts": 121,
      "fgm": 47,
      "fga": 92,
      "tpm": 12,
      "tpa": 34,
      "ftm": 15,
      "fta": 18,
      "oreb": 8,
      "dreb": 31,
      "reb": 39,
      "ast": 32,
      "stl": 3,
      "blk": 4,
      "tov": 10,
      "pf": 13,
      "fast_break_pts": 8,
      "paint_pts": 54,
      "points_off_turnovers": 14,
      "largest_lead": 7
    }
  ],
  "players": [
    {
      "player_id": "3136776",
      "name": "D'Angelo Russell",
      "team_id": "13",
      "position": "G",
      "starter": true,
      "did_not_play": false,
      "minutes": 40,
      "pts": 23,
      "fgm": 9,
      "fga": 21,
      "tpm": 3,
      "tpa": 10,
      "ftm": 2,
      "fta": 2,
      "oreb": 1,
      "dreb": 2,
      "reb": 3,
      "ast": 13,
      "stl": 1,
      "blk": 0,
      "tov": 0,
      "pf": 2,
      "plus_minus": -14
    },
    {
      "player_id": "1966",
      "name": "LeBron James",
      "team_id": "13",
      "position": "F",
      "starter": true,
      "did_not_play": false,
      "minutes": 38,
      "pts": 40,
      "fgm": 15,
      "fga": 23,
      "tpm": 3,
      "tpa": 5,
      "ftm": 7,
      "fta": 8,
      "oreb": 3,
      "dreb": 5,
      "reb": 8,
      "ast": 9,
      "stl": 1,
      "blk": 1,
      "tov": 4,
      "pf": 1,
      "plus_minus": -6
    },
    {
      "player_id": "4066457",
      "name": "Austin Reaves",
      "team_id": "13",
      "position": "G",
      "starter": true,
      "did_not_play": false,
      "minutes": 34,
      "pts": 11,
      "fgm": 4,
      "fga": 13,
      "tpm": 2,
      "tpa": 9,
      "ftm": 1,
      "fta": 1,
      "oreb": 0,
      "dreb": 3,
      "reb": 3,
      "ast": 3,
      "stl": 0,
      "blk": 0,
      "tov": 3,
      "pf": 0,
      "plus_minus": -5
    }
  ],
  "odds": [
    {
      "provider": "BetfairSportsbook",
      "home_ml_open": -163,
      "home_ml_close": -125,
      "away_ml_open": 125,
      "away_ml_close": 100,
      "home_spread_open": -3,
      "home_spread_close": -1.5,
      "total_open": 240.5,
      "total_close": 233.5
    },
    {
      "provider": "Caesars Sportsbook (Colorado)",
      "home_ml_open": -155,
      "home_ml_close": -125,
      "away_ml_open": 130,
      "away_ml_close": 105,
      "home_spread_open": -3.5,
      "home_spread_close": -1.5,
      "total_open": 236.5,
      "total_close": 233.5
    },
    {
      "provider": "Caesars Sportsbook (New Jersey)",
      "home_ml_open": -155,
      "home_ml_close": -120,
      "away_ml_open": 130,
      "away_ml_close": 100,
      "home_spread_open": -3.5,
      "home_spread_close": -1.5,
      "total_open": 236.5,
      "total_close": 233.5
    }
  ],
  "win_probability": {
    "home_min": 0,
    "home_max": 0.729,
    "plays_with_probability": 452
  },
  "plays": 452
}

Response fields

gameobject
game.game_idstring
game.seasonnumber
game.season_typestring
game.datestring
game.starts_atstring
game.statusstring
game.homeobject
game.home.team_idstring
game.home.abbrevstring
game.home.namestring
game.home.scorenumber
game.awayobject
game.away.team_idstring
game.away.abbrevstring
game.away.namestring
game.away.scorenumber
game.periodsnumber
game.overtime_periodsnumber
game.neutral_siteboolean
game.conference_gameboolean
game.venuestring
game.citystring
game.attendancenumber
team_stats[]array
List of objects
team_stats[].team_idstring
team_stats[].abbrevstring
team_stats[].homeboolean
team_stats[].ptsnumber
team_stats[].fgmnumber
team_stats[].fganumber
team_stats[].tpmnumber
team_stats[].tpanumber
team_stats[].ftmnumber
team_stats[].ftanumber
team_stats[].orebnumber
team_stats[].drebnumber
team_stats[].rebnumber
team_stats[].astnumber
team_stats[].stlnumber

Related endpoints

Try it

500 credits free on signup: 100 calls to get_game, and no card.