get_schedule
2 creditsBasic lookupPOST /v1/get_schedule
Data refreshed · changelog
Upcoming games with the median line across sportsbooks
Use it when you want the coming week's games with the median moneyline, run line and total across the posted sportsbooks.
Parameters
daysintegeroptionalteamstringoptional- Team id or abbreviation.
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_scheduleitself. 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_schedule \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"days": 7
}'Response
json
{
"days": 7,
"games": [
{
"game_id": "401908028",
"season": 2026,
"season_type": "postseason",
"date": "2026-10-19",
"starts_at": "2026-10-20T00:00:00.000Z",
"status": "scheduled",
"home": {
"team_id": "30",
"abbrev": "TB",
"name": "Tampa Bay Rays",
"runs": null,
"hits": null,
"errors": null
},
"away": {
"team_id": "5",
"abbrev": "CLE",
"name": "Cleveland Guardians",
"runs": null,
"hits": null,
"errors": null
},
"innings": null,
"extra_innings": null,
"venue": "Tropicana Field",
"city": "St. Petersburg",
"attendance": null,
"line": {
"books": 8,
"home_ml": -151,
"away_ml": 130,
"home_run_line": -1.5,
"total": 6.5,
"home_implied_prob": 0.602
}
},
{
"game_id": "401908029",
"season": 2026,
"season_type": "postseason",
"date": "2026-10-20",
"starts_at": "2026-10-21T00:00:00.000Z",
"status": "scheduled",
"home": {
"team_id": "30",
"abbrev": "TB",
"name": "Tampa Bay Rays",
"runs": null,
"hits": null,
"errors": null
},
"away": {
"team_id": "5",
"abbrev": "CLE",
"name": "Cleveland Guardians",
"runs": null,
"hits": null,
"errors": null
},
"innings": null,
"extra_innings": null,
"venue": "Tropicana Field",
"city": "St. Petersburg",
"attendance": null,
"line": null
},
{
"game_id": "401908042",
"season": 2026,
"season_type": "postseason",
"date": "2026-10-23",
"starts_at": "2026-10-24T00:00:00.000Z",
"status": "scheduled",
"home": {
"team_id": "8",
"abbrev": "MIL",
"name": "Milwaukee Brewers",
"runs": null,
"hits": null,
"errors": null
},
"away": {
"team_id": "-2",
"abbrev": "TBD",
"name": "TBD",
"runs": null,
"hits": null,
"errors": null
},
"innings": null,
"extra_innings": null,
"venue": "American Family Field",
"city": "Milwaukee",
"attendance": null,
"line": null
}
],
"count": 4
}Response fields
daysnumbergames[]array- List of objects
games[].game_idstringgames[].seasonnumbergames[].season_typestringgames[].datestringgames[].starts_atstringgames[].statusstringgames[].homeobjectgames[].home.team_idstringgames[].home.abbrevstringgames[].home.namestringgames[].home.runsnullgames[].home.hitsnullgames[].home.errorsnullgames[].awayobjectgames[].away.team_idstringgames[].away.abbrevstringgames[].away.namestringgames[].away.runsnullgames[].away.hitsnullgames[].away.errorsnullgames[].inningsnullgames[].extra_inningsnullgames[].venuestringgames[].citystringgames[].attendancenullgames[].lineobjectgames[].line.booksnumbergames[].line.home_mlnumbergames[].line.away_mlnumbergames[].line.home_run_linenumbergames[].line.totalnumbergames[].line.home_implied_probnumbercountnumber
Used in
- MLB odds history: Each sportsbook's moneyline, run line and total for MLB games, with whether the favourite won and the total went over. Built for backtests. REST or MCP.
Related endpoints
get_game5 cr
Takes the game_id this one returns.
One game: every batting and pitching line, each book's line, win probability
get_line_movement10 cr
Takes the game_id this one returns.
Snapshots of each sportsbook's line before first pitch
list_teams1 cr
Returns the team this one takes.
Team ids, abbreviations and colours for a season
get_games2 cr
Takes the team this one returns.
Games with runs, hits and errors by season, date, range or team
Try it
500 free credits every month: 250 calls to get_schedule, and no card.