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 spread, total and moneylines across the posted sportsbooks.

Parameters

daysintegeroptional
Days ahead (default 7).
teamstringoptional
Team id or abbreviation.
leagueenum: nba | wnba | ncaam | ncaaw | nbloptional
League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw, nbl.

Notes

  • Over MCP, ask for it in plain English and the client calls get_schedule itself. Point any MCP client at https://mcp.dunkapi.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.dunkapi.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": "401909938",
      "season": 2027,
      "season_type": "regular",
      "date": "2026-11-07",
      "starts_at": "2026-11-07T22:00:00.000Z",
      "status": "scheduled",
      "home": {
        "team_id": "11",
        "abbrev": "IND",
        "name": "Indiana Pacers",
        "score": null
      },
      "away": {
        "team_id": "7",
        "abbrev": "DEN",
        "name": "Denver Nuggets",
        "score": null
      },
      "periods": null,
      "overtime_periods": null,
      "neutral_site": true,
      "conference_game": false,
      "venue": "Arena CDMX",
      "city": "Mexico City",
      "attendance": null,
      "line": {
        "books": 8,
        "home_spread": 7.5,
        "total": 229.5,
        "home_ml": 260,
        "away_ml": -319,
        "home_implied_prob": 0.278
      }
    },
    {
      "game_id": "401909939",
      "season": 2027,
      "season_type": "regular",
      "date": "2026-11-07",
      "starts_at": "2026-11-08T00:30:00.000Z",
      "status": "scheduled",
      "home": {
        "team_id": "1",
        "abbrev": "ATL",
        "name": "Atlanta Hawks",
        "score": null
      },
      "away": {
        "team_id": "17",
        "abbrev": "BKN",
        "name": "Brooklyn Nets",
        "score": null
      },
      "periods": null,
      "overtime_periods": null,
      "neutral_site": false,
      "conference_game": true,
      "venue": "State Farm Arena",
      "city": "Atlanta",
      "attendance": null,
      "line": {
        "books": 8,
        "home_spread": -7.5,
        "total": 227.5,
        "home_ml": -290,
        "away_ml": 231,
        "home_implied_prob": 0.744
      }
    },
    {
      "game_id": "401909940",
      "season": 2027,
      "season_type": "regular",
      "date": "2026-11-07",
      "starts_at": "2026-11-08T01:00:00.000Z",
      "status": "scheduled",
      "home": {
        "team_id": "5",
        "abbrev": "CLE",
        "name": "Cleveland Cavaliers",
        "score": null
      },
      "away": {
        "team_id": "18",
        "abbrev": "NY",
        "name": "New York Knicks",
        "score": null
      },
      "periods": null,
      "overtime_periods": null,
      "neutral_site": false,
      "conference_game": true,
      "venue": "Rocket Arena",
      "city": "Cleveland",
      "attendance": null,
      "line": {
        "books": 8,
        "home_spread": 5.3,
        "total": 223,
        "home_ml": 170,
        "away_ml": -200,
        "home_implied_prob": 0.37
      }
    }
  ],
  "count": 51
}

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.scorenull
games[].awayobject
games[].away.team_idstring
games[].away.abbrevstring
games[].away.namestring
games[].away.scorenull
games[].periodsnull
games[].overtime_periodsnull
games[].neutral_siteboolean
games[].conference_gameboolean
games[].venuestring
games[].citystring
games[].attendancenull
games[].lineobject
games[].line.booksnumber
games[].line.home_spreadnumber
games[].line.totalnumber
games[].line.home_mlnumber
games[].line.away_mlnumber
games[].line.home_implied_probnumber
countnumber

Used in

  • NBA odds history: Each sportsbook's moneyline, spread and total for NBA games from 2013-14, with results against the line. Built for backtests. REST or MCP.

Related endpoints

Try it

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