Skip to content

get_schedule

2 creditsBasic lookupPOST /v1/get_schedule

Data refreshed · changelog

Upcoming games by week or for the next N days

Use it when you want what is coming up this week, with kickoff times in UTC and posted lines.

Parameters

teamstringoptional
Team code to filter
weekintegeroptional
A specific week of the current season (returns all games that week, played or not)
daysintegeroptional
Days ahead to look when week is not set (default 7)

Notes

  • Over MCP, ask for it in plain English and the client calls get_schedule itself. Point any MCP client at https://mcp.endzoneapi.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.endzoneapi.com/v1/get_schedule \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "days": 7
}'

Response

json
{
  "season": 2026,
  "week": null,
  "days": 7,
  "upcoming_games": [
    {
      "game_id": "2026_09_JAX_BAL",
      "season": 2026,
      "game_type": "REG",
      "week": 9,
      "gameday": "2026-11-05",
      "weekday": "Thursday",
      "kickoff": "2026-11-06T01:15:00.000Z",
      "away_team": "JAX",
      "home_team": "BAL",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Home",
      "stadium": "M&T Bank Stadium",
      "roof": "outdoors",
      "surface": "grass",
      "temp": null,
      "wind": null,
      "div_game": false,
      "away_rest": 4,
      "home_rest": 4,
      "spread_line": -10,
      "total_line": 39.5,
      "away_moneyline": -535,
      "home_moneyline": 400,
      "away_qb_name": "Trevor Lawrence",
      "home_qb_name": "Joe Fagnano",
      "away_qb_id": "00-0036971",
      "home_qb_id": "00-0040981",
      "away_coach": "Liam Coen",
      "home_coach": "Jesse Minter",
      "referee": null,
      "espn_id": "401873037",
      "pfr_id": "202611050rav"
    },
    {
      "game_id": "2026_09_CIN_ATL",
      "season": 2026,
      "game_type": "REG",
      "week": 9,
      "gameday": "2026-11-08",
      "weekday": "Sunday",
      "kickoff": "2026-11-08T14:30:00.000Z",
      "away_team": "CIN",
      "home_team": "ATL",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Neutral",
      "stadium": "Bernabeu",
      "roof": null,
      "surface": "fieldturf",
      "temp": null,
      "wind": null,
      "div_game": false,
      "away_rest": 7,
      "home_rest": 7,
      "spread_line": -3,
      "total_line": 52.5,
      "away_moneyline": -155,
      "home_moneyline": 130,
      "away_qb_name": "Joe Burrow",
      "home_qb_name": "Michael Penix Jr.",
      "away_qb_id": "00-0036442",
      "home_qb_id": "00-0039917",
      "away_coach": "Zac Taylor",
      "home_coach": "Raheem Morris",
      "referee": null,
      "espn_id": "401873038",
      "pfr_id": "202611080atl"
    },
    {
      "game_id": "2026_09_LA_WAS",
      "season": 2026,
      "game_type": "REG",
      "week": 9,
      "gameday": "2026-11-08",
      "weekday": "Sunday",
      "kickoff": "2026-11-08T18:00:00.000Z",
      "away_team": "LA",
      "home_team": "WAS",
      "away_score": null,
      "home_score": null,
      "result": null,
      "total": null,
      "overtime": null,
      "status": "FUT",
      "location": "Home",
      "stadium": "Northwest Stadium",
      "roof": "outdoors",
      "surface": "grass",
      "temp": null,
      "wind": null,
      "div_game": false,
      "away_rest": 7,
      "home_rest": 7,
      "spread_line": -5.5,
      "total_line": 47.5,
      "away_moneyline": -225,
      "home_moneyline": 185,
      "away_qb_name": "Matthew Stafford",
      "home_qb_name": "Jayden Daniels",
      "away_qb_id": "00-0026498",
      "home_qb_id": "00-0039910",
      "away_coach": "Sean McVay",
      "home_coach": "Dan Quinn",
      "referee": null,
      "espn_id": "401873043",
      "pfr_id": "202611080was"
    }
  ],
  "count": 15
}

Response fields

seasonnumber
weeknull
daysnumber
upcoming_games[]array
List of objects
upcoming_games[].game_idstring
upcoming_games[].seasonnumber
upcoming_games[].game_typestring
upcoming_games[].weeknumber
upcoming_games[].gamedaystring
upcoming_games[].weekdaystring
upcoming_games[].kickoffstring
upcoming_games[].away_teamstring
upcoming_games[].home_teamstring
upcoming_games[].away_scorenull
upcoming_games[].home_scorenull
upcoming_games[].resultnull
upcoming_games[].totalnull
upcoming_games[].overtimenull
upcoming_games[].statusstring
upcoming_games[].locationstring
upcoming_games[].stadiumstring
upcoming_games[].roofstring
upcoming_games[].surfacestring
upcoming_games[].tempnull
upcoming_games[].windnull
upcoming_games[].div_gameboolean
upcoming_games[].away_restnumber
upcoming_games[].home_restnumber
upcoming_games[].spread_linenumber
upcoming_games[].total_linenumber
upcoming_games[].away_moneylinenumber
upcoming_games[].home_moneylinenumber
upcoming_games[].away_qb_namestring
upcoming_games[].home_qb_namestring
upcoming_games[].away_qb_idstring
upcoming_games[].home_qb_idstring
upcoming_games[].away_coachstring
upcoming_games[].home_coachstring
upcoming_games[].refereenull
upcoming_games[].espn_idstring

Related endpoints

Try it

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