Skip to content

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

daysintegeroptional
teamstringoptional
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_schedule 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_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

daysnumber
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.runsnull
games[].home.hitsnull
games[].home.errorsnull
games[].awayobject
games[].away.team_idstring
games[].away.abbrevstring
games[].away.namestring
games[].away.runsnull
games[].away.hitsnull
games[].away.errorsnull
games[].inningsnull
games[].extra_inningsnull
games[].venuestring
games[].citystring
games[].attendancenull
games[].lineobject
games[].line.booksnumber
games[].line.home_mlnumber
games[].line.away_mlnumber
games[].line.home_run_linenumber
games[].line.totalnumber
games[].line.home_implied_probnumber
countnumber

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

Try it

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