Skip to content

get_player_games

5 creditsStats + aggregationPOST /v1/get_player_games

A player's full batting and pitching game log

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

Parameters

player_idstringrequired
seasonnumber | stringoptional
Season (a year, e.g. 2025; default: the latest).
season_typeenum: regular | postseasonoptional
limitintegeroptional
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.fastballapi.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.fastballapi.com/v1/get_player_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "30951",
  "season": 2024,
  "limit": 3
}'

Response

json
{
  "player_id": "30951",
  "batting": [
    {
      "game_id": "401701021",
      "date": "2024-10-09",
      "season": 2024,
      "opponent": "NYM",
      "home": false,
      "batting_order": 3,
      "position": "1B",
      "ab": 3,
      "r": 1,
      "h": 1,
      "rbi": 0,
      "hr": 0,
      "bb": 1,
      "so": 1,
      "pitches_seen": 16
    },
    {
      "game_id": "401701020",
      "date": "2024-10-08",
      "season": 2024,
      "opponent": "NYM",
      "home": false,
      "batting_order": 3,
      "position": "1B",
      "ab": 4,
      "r": 0,
      "h": 1,
      "rbi": 1,
      "hr": 0,
      "bb": 0,
      "so": 1,
      "pitches_seen": 14
    },
    {
      "game_id": "401701018",
      "date": "2024-10-06",
      "season": 2024,
      "opponent": "NYM",
      "home": true,
      "batting_order": 3,
      "position": "1B",
      "ab": 3,
      "r": 2,
      "h": 1,
      "rbi": 2,
      "hr": 1,
      "bb": 2,
      "so": 2,
      "pitches_seen": 28
    }
  ],
  "pitching": [],
  "count": 3,
  "next_offset": 3
}

Response fields

player_idstring
batting[]array
List of objects
batting[].game_idstring
batting[].datestring
batting[].seasonnumber
batting[].opponentstring
batting[].homeboolean
batting[].batting_ordernumber
batting[].positionstring
batting[].abnumber
batting[].rnumber
batting[].hnumber
batting[].rbinumber
batting[].hrnumber
batting[].bbnumber
batting[].sonumber
batting[].pitches_seennumber
pitching[]array
List
countnumber
next_offsetnumber

Related endpoints

Try it

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