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- Player 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).
offsetintegeroptionalleagueenum: 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_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": 2026,
"limit": 3
}'Response
json
{
"player_id": "4065648",
"games": [
{
"game_id": "401869412",
"date": "2026-05-02",
"season": 2026,
"season_type": 3,
"opponent": "PHI",
"home": true,
"result": "L",
"starter": false,
"did_not_play": true,
"reason": "LEFT KNEE STIFFNESS",
"minutes": null,
"pts": null,
"fgm": null,
"fga": null,
"tpm": null,
"tpa": null,
"ftm": null,
"fta": null,
"oreb": null,
"dreb": null,
"reb": null,
"ast": null,
"stl": null,
"blk": null,
"tov": null,
"pf": null,
"plus_minus": null
},
{
"game_id": "401869410",
"date": "2026-04-30",
"season": 2026,
"season_type": 3,
"opponent": "PHI",
"home": false,
"result": "L",
"starter": true,
"did_not_play": false,
"minutes": 29,
"pts": 17,
"fgm": 6,
"fga": 13,
"tpm": 2,
"tpa": 6,
"ftm": 3,
"fta": 5,
"oreb": 0,
"dreb": 11,
"reb": 11,
"ast": 3,
"stl": 0,
"blk": 0,
"tov": 3,
"pf": 1,
"plus_minus": -11
},
{
"game_id": "401869408",
"date": "2026-04-28",
"season": 2026,
"season_type": 3,
"opponent": "PHI",
"home": true,
"result": "L",
"starter": true,
"did_not_play": false,
"minutes": 41,
"pts": 24,
"fgm": 8,
"fga": 19,
"tpm": 4,
"tpa": 12,
"ftm": 4,
"fta": 7,
"oreb": 3,
"dreb": 13,
"reb": 16,
"ast": 4,
"stl": 3,
"blk": 0,
"tov": 4,
"pf": 0,
"plus_minus": -9
}
],
"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[].reasonstringgames[].minutesnullgames[].ptsnullgames[].fgmnullgames[].fganullgames[].tpmnullgames[].tpanullgames[].ftmnullgames[].ftanullgames[].orebnullgames[].drebnullgames[].rebnullgames[].astnullgames[].stlnullgames[].blknullgames[].tovnullgames[].pfnullgames[].plus_minusnullcountnumbernext_offsetnumber
Used in
- NBA play-by-play data: Play-by-play for every NBA season since 2003-04: clock, score, players, shot type and location, and win probability from 2018. REST or MCP.
- Guide: How do I get an NBA player's game log and a rolling average?
Related endpoints
get_alt_lines10 cr
Takes the game_id this one returns.
Alternate spreads and totals by sportsbook: every point on each book's ladder, opening and closing, NBA, WNBA and men's college from 2023-24
get_prop_movement10 cr
Takes the player_id this one returns.
How one player's prop line moved before a game, every capture by sportsbook
get_shot_chart10 cr
Takes the player_id this one returns.
Shot profile by zone for a player, team or defence, with every shot's x/y
get_leaders5 cr
Returns the player_id this one takes.
Season leaders per game, by percentage or in total
Try it
500 free credits every month: 100 calls to get_player_games, and no card.