Skip to content

get_player_games

5 creditsStats + aggregationPOST /v1/get_player_games

A player's full game log

Use it when you need every game's box-score line for a player, for prop models, form charts or streaks.

Parameters

player_idstringrequired
ESPN athlete id.
seasonnumber | stringoptional
Season by the year it ends: 2025 = 2024-25 (default: the latest).
season_typeenum: regular | postseason | play_in | preseasonoptional
limitintegeroptional
Max games (default 100).
offsetintegeroptional

Notes

  • Over MCP, ask for it in plain English and the client calls get_player_games 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_player_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "4065648",
  "season": 2024,
  "limit": 3
}'

Response

json
{
  "player_id": "4065648",
  "games": [
    {
      "game_id": "401656363",
      "date": "2024-06-17",
      "season": 2024,
      "season_type": 3,
      "opponent": "DAL",
      "home": true,
      "result": "W",
      "starter": true,
      "did_not_play": false,
      "minutes": 45,
      "pts": 31,
      "fgm": 11,
      "fga": 24,
      "tpm": 1,
      "tpa": 7,
      "ftm": 8,
      "fta": 8,
      "oreb": 1,
      "dreb": 7,
      "reb": 8,
      "ast": 11,
      "stl": 2,
      "blk": 0,
      "tov": 2,
      "pf": 2,
      "plus_minus": 18
    },
    {
      "game_id": "401656362",
      "date": "2024-06-14",
      "season": 2024,
      "season_type": 3,
      "opponent": "DAL",
      "home": false,
      "result": "L",
      "starter": true,
      "did_not_play": false,
      "minutes": 27,
      "pts": 15,
      "fgm": 4,
      "fga": 10,
      "tpm": 1,
      "tpa": 4,
      "ftm": 6,
      "fta": 6,
      "oreb": 0,
      "dreb": 5,
      "reb": 5,
      "ast": 3,
      "stl": 1,
      "blk": 2,
      "tov": 3,
      "pf": 4,
      "plus_minus": -33
    },
    {
      "game_id": "401656361",
      "date": "2024-06-12",
      "season": 2024,
      "season_type": 3,
      "opponent": "DAL",
      "home": false,
      "result": "W",
      "starter": true,
      "did_not_play": false,
      "minutes": 42,
      "pts": 31,
      "fgm": 11,
      "fga": 26,
      "tpm": 4,
      "tpa": 13,
      "ftm": 5,
      "fta": 5,
      "oreb": 0,
      "dreb": 6,
      "reb": 6,
      "ast": 5,
      "stl": 1,
      "blk": 0,
      "tov": 2,
      "pf": 2,
      "plus_minus": -4
    }
  ],
  "count": 3,
  "next_offset": 3
}

Response fields

player_idstring
games[]array
List of objects
games[].game_idstring
games[].datestring
games[].seasonnumber
games[].season_typenumber
games[].opponentstring
games[].homeboolean
games[].resultstring
games[].starterboolean
games[].did_not_playboolean
games[].minutesnumber
games[].ptsnumber
games[].fgmnumber
games[].fganumber
games[].tpmnumber
games[].tpanumber
games[].ftmnumber
games[].ftanumber
games[].orebnumber
games[].drebnumber
games[].rebnumber
games[].astnumber
games[].stlnumber
games[].blknumber
games[].tovnumber
games[].pfnumber
games[].plus_minusnumber
countnumber
next_offsetnumber

Related endpoints

Try it

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