get_games

5 creditsStats + aggregationPOST /v1/get_games

Data refreshed Nov 6, 2026 · changelog

Query games by season, week, team, date, type, or status, with closing lines

Use it when you need games with scores and closing lines for a season, week, team, or date range. The consensus closing spread and total are on every game since 1999, which makes this the backtest table.

Parameters

seasonstring | numberoptional: Season year (e.g. 2025)
weekintegeroptional: Week number (1-18 regular season; 19+ postseason)
teamstringoptional: Team code (home or away)
date_fromstringoptional: Start date YYYY-MM-DD
date_tostringoptional: End date YYYY-MM-DD
game_typeenum: REG | WC | DIV | CON | SB | POSToptional: REG, WC, DIV, CON, SB, or POST for any playoff game
statusenum: FUT | LIVE | FINALoptional: Game status
limitintegeroptional: Max results (default 100)

Notes

Over MCP, ask for it in plain English and the client calls get_games itself. Point any MCP client at https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 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_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2025,
  "week": 1,
  "team": "KC"
}'

Response

json

{
  "games": [
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "game_type": "REG",
      "week": 1,
      "gameday": "2025-09-05",
      "weekday": "Friday",
      "kickoff": "2025-09-06T00:00:00.000Z",
      "away_team": "KC",
      "home_team": "LAC",
      "away_score": 21,
      "home_score": 27,
      "result": 6,
      "total": 48,
      "overtime": 0,
      "status": "FINAL",
      "location": "Neutral",
      "stadium": "SoFi Stadium",
      "roof": "dome",
      "surface": null,
      "temp": null,
      "wind": null,
      "div_game": true,
      "away_rest": 7,
      "home_rest": 7,
      "spread_line": -3,
      "total_line": 47.5,
      "away_moneyline": -175,
      "home_moneyline": 145,
      "away_qb_name": "Patrick Mahomes",
      "home_qb_name": "Justin Herbert",
      "away_qb_id": "00-0033873",
      "home_qb_id": "00-0036355",
      "away_coach": "Andy Reid",
      "home_coach": "Jim Harbaugh",
      "referee": "Carl Cheffers",
      "espn_id": "401772714",
      "pfr_id": "202509050sdg"
    }
  ],
  "count": 1,
  "filters": {
    "season": 2025,
    "week": 1,
    "team": "KC"
  }
}