Skip to content

get_games

2 creditsBasic lookupPOST /v1/get_games

Data refreshed · changelog

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
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

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": 2025,
  "limit": 3
}'

Response

json
{
  "games": [
    {
      "game_id": "401809281",
      "season": 2025,
      "season_type": "postseason",
      "date": "2025-10-09",
      "starts_at": "2025-10-09T22:08:00.000Z",
      "status": "final",
      "home": {
        "team_id": "19",
        "abbrev": "LAD",
        "name": "Los Angeles Dodgers",
        "runs": 2,
        "hits": 7,
        "errors": 1
      },
      "away": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 1,
        "hits": 4,
        "errors": 2
      },
      "innings": 11,
      "extra_innings": true,
      "venue": "Dodger Stadium",
      "city": "Los Angeles",
      "attendance": 50563
    },
    {
      "game_id": "401809280",
      "season": 2025,
      "season_type": "postseason",
      "date": "2025-10-08",
      "starts_at": "2025-10-09T01:08:00.000Z",
      "status": "final",
      "home": {
        "team_id": "19",
        "abbrev": "LAD",
        "name": "Los Angeles Dodgers",
        "runs": 2,
        "hits": 8,
        "errors": 2
      },
      "away": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 8,
        "hits": 12,
        "errors": 0
      },
      "innings": 9,
      "extra_innings": false,
      "venue": "Dodger Stadium",
      "city": "Los Angeles",
      "attendance": 53689
    },
    {
      "game_id": "401809279",
      "season": 2025,
      "season_type": "postseason",
      "date": "2025-10-06",
      "starts_at": "2025-10-06T22:08:00.000Z",
      "status": "final",
      "home": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 3,
        "hits": 7,
        "errors": 0
      },
      "away": {
        "team_id": "19",
        "abbrev": "LAD",
        "name": "Los Angeles Dodgers",
        "runs": 4,
        "hits": 7,
        "errors": 0
      },
      "innings": 9,
      "extra_innings": false,
      "venue": "Citizens Bank Park",
      "city": "Philadelphia",
      "attendance": 45653
    }
  ],
  "count": 3,
  "next_offset": 3
}

Response fields

games[]array
List of objects
games[].game_idstring
games[].seasonnumber
games[].season_typestring
games[].datestring
games[].starts_atstring
games[].statusstring
games[].homeobject
games[].home.team_idstring
games[].home.abbrevstring
games[].home.namestring
games[].home.runsnumber
games[].home.hitsnumber
games[].home.errorsnumber
games[].awayobject
games[].away.team_idstring
games[].away.abbrevstring
games[].away.namestring
games[].away.runsnumber
games[].away.hitsnumber
games[].away.errorsnumber
games[].inningsnumber
games[].extra_inningsboolean
games[].venuestring
games[].citystring
games[].attendancenumber
countnumber
next_offsetnumber

Used in

Related endpoints

Try it

500 free credits every month: 250 calls to get_games, and no card.