get_games

2 creditsBasic lookupPOST /v1/get_games

Games with runs, hits and errors by season, date, range or team

Use it when you want scores for a date, a date range, a team or a season, newest first, with game ids for the detail endpoints.

Parameters

seasonnumber | stringoptional: Season (a year, e.g. 2025; default: the latest).
season_typeenum: regular | postseasonoptional: regular or postseason (default both).
teamstringoptional: Team id or abbreviation.
datestringoptional: One date, YYYY-MM-DD (US Eastern).
fromstringoptional: From date, YYYY-MM-DD.
tostringoptional: To date, YYYY-MM-DD.
statusenum: scheduled | finaloptional
limitintegeroptional: Max games (default 50).
offsetintegeroptional

Notes

Over MCP, ask for it in plain English and the client calls get_games itself. Point any MCP client at https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 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_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "PHI",
  "season": 2024,
  "limit": 3
}'

Response

json

{
  "games": [
    {
      "game_id": "401701021",
      "season": 2024,
      "season_type": "postseason",
      "date": "2024-10-09",
      "starts_at": "2024-10-09T21:08:00.000Z",
      "status": "final",
      "home": {
        "team_id": "21",
        "abbrev": "NYM",
        "name": "New York Mets",
        "runs": 4,
        "hits": 8,
        "errors": 1
      },
      "away": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 1,
        "hits": 4,
        "errors": 0
      },
      "innings": 9,
      "extra_innings": false,
      "venue": "Citi Field",
      "city": "Queens",
      "attendance": 44103
    },
    {
      "game_id": "401701020",
      "season": 2024,
      "season_type": "postseason",
      "date": "2024-10-08",
      "starts_at": "2024-10-08T21:08:00.000Z",
      "status": "final",
      "home": {
        "team_id": "21",
        "abbrev": "NYM",
        "name": "New York Mets",
        "runs": 7,
        "hits": 9,
        "errors": 0
      },
      "away": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 2,
        "hits": 5,
        "errors": 1
      },
      "innings": 9,
      "extra_innings": false,
      "venue": "Citi Field",
      "city": "Queens",
      "attendance": 44093
    },
    {
      "game_id": "401701018",
      "season": 2024,
      "season_type": "postseason",
      "date": "2024-10-06",
      "starts_at": "2024-10-06T20:08:00.000Z",
      "status": "final",
      "home": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 7,
        "hits": 10,
        "errors": 1
      },
      "away": {
        "team_id": "21",
        "abbrev": "NYM",
        "name": "New York Mets",
        "runs": 6,
        "hits": 11,
        "errors": 1
      },
      "innings": 9,
      "extra_innings": false,
      "venue": "Citizens Bank Park",
      "city": "Philadelphia",
      "attendance": 45679
    }
  ],
  "count": 3,
  "next_offset": 3
}