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 | preseasonoptionallimitintegeroptional- Max games (default 100).
offsetintegeroptional
Notes
- Over MCP, ask for it in plain English and the client calls
get_player_gamesitself. Point any MCP client athttps://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_idstringgames[]array- List of objects
games[].game_idstringgames[].datestringgames[].seasonnumbergames[].season_typenumbergames[].opponentstringgames[].homebooleangames[].resultstringgames[].starterbooleangames[].did_not_playbooleangames[].minutesnumbergames[].ptsnumbergames[].fgmnumbergames[].fganumbergames[].tpmnumbergames[].tpanumbergames[].ftmnumbergames[].ftanumbergames[].orebnumbergames[].drebnumbergames[].rebnumbergames[].astnumbergames[].stlnumbergames[].blknumbergames[].tovnumbergames[].pfnumbergames[].plus_minusnumbercountnumbernext_offsetnumber
Related endpoints
search_players1 cr
Returns the player_id this one takes.
Find players by name
get_game5 cr
Takes the game_id this one returns.
One game: both box scores, every player's line, each book's line, win probability
get_player5 cr
Takes the player_id this one returns.
Profile, per-season averages and shooting splits, last 10 games
get_leaders5 cr
Returns the player_id this one takes.
Season leaders per game, by percentage or in total
Try it
500 credits free on signup: 100 calls to get_player_games, and no card.