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 | finaloptionallimitintegeroptional- Max games (default 50).
offsetintegeroptionalleagueenum: mlb | ncaabaseoptional- League. Defaults to mlb. One of: mlb, ncaabase.
Notes
- Over MCP, ask for it in plain English and the client calls
get_gamesitself. Point any MCP client athttps://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_idstringgames[].seasonnumbergames[].season_typestringgames[].datestringgames[].starts_atstringgames[].statusstringgames[].homeobjectgames[].home.team_idstringgames[].home.abbrevstringgames[].home.namestringgames[].home.runsnumbergames[].home.hitsnumbergames[].home.errorsnumbergames[].awayobjectgames[].away.team_idstringgames[].away.abbrevstringgames[].away.namestringgames[].away.runsnumbergames[].away.hitsnumbergames[].away.errorsnumbergames[].inningsnumbergames[].extra_inningsbooleangames[].venuestringgames[].citystringgames[].attendancenumbercountnumbernext_offsetnumber
Used in
Related endpoints
get_player_props10 cr
Takes the game_id this one returns.
Player prop lines by sportsbook: the closing line (one pre-game capture per line before October 2026)
get_ratings2 cr
Returns the team this one takes.
Our team Elo ratings, ranked
get_spray_chart10 cr
Takes the team this one returns.
Where a batter or team hits the ball, by trajectory and field
get_team_stats5 cr
Takes the team this one returns.
Runs for and against, team batting and opponents' batting
Try it
500 free credits every month: 250 calls to get_games, and no card.