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_scheduleitself. Point any MCP client athttps://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
daysnumbergames[]array- List of objects
games[].game_idstringgames[].seasonnumbergames[].season_typestringgames[].datestringgames[].starts_atstringgames[].statusstringgames[].homeobjectgames[].home.team_idstringgames[].home.abbrevstringgames[].home.namestringgames[].home.scorenullgames[].awayobjectgames[].away.team_idstringgames[].away.abbrevstringgames[].away.namestringgames[].away.scorenullgames[].periodsnullgames[].overtime_periodsnullgames[].neutral_sitebooleangames[].conference_gamebooleangames[].venuestringgames[].citystringgames[].attendancenullgames[].lineobjectgames[].line.booksnumbergames[].line.home_spreadnumbergames[].line.totalnumbergames[].line.home_mlnumbergames[].line.away_mlnumbergames[].line.home_implied_probnumbercountnumber
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
get_game5 cr
Takes the game_id this one returns.
One game: both box scores, every player's line, each book's line, win probability
get_game_probabilities5 cr
Takes the game_id this one returns.
What the market thinks of a game: average implied and fair probability for the moneyline, spreads and totals
list_teams1 cr
Returns the team this one takes.
Team ids, abbreviations and colours for a season
get_prop_backtest25 cr
Takes the team this one returns.
How often a kind of player prop hit against what the market implied, by your filters, since May 2023
Try it
500 free credits every month: 250 calls to get_schedule, and no card.