list_games

2 creditsBasic lookupPOST /v1/list_games

Games with scores by season, date, range or team

Use it when you want scores for a date, a date range, a team or a season, newest first, with game ids for the detail endpoints.

Parameters

seasonnumber | stringoptional: Season by the year it ends: 2025 = 2024-25.
season_typeenum: regular | postseason | play_in | preseasonoptional: regular, postseason, play_in or preseason.
teamstringoptional: Team id or abbreviation.
datestringoptional: One date, YYYY-MM-DD (US Eastern).
fromstringoptional: From date, YYYY-MM-DD.
tostringoptional: To date, YYYY-MM-DD.
statusenum: scheduled | finaloptional
limitintegeroptional: Max games (default 50).
offsetintegeroptional: Page offset; use next_offset.

Notes

Over MCP, ask for it in plain English and the client calls list_games 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/list_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "BOS",
  "season": 2024,
  "limit": 3
}'

Response

json

{
  "games": [
    {
      "game_id": "401656363",
      "season": 2024,
      "season_type": "postseason",
      "date": "2024-06-17",
      "starts_at": "2024-06-18T00:30:00.000Z",
      "status": "final",
      "home": {
        "team_id": "2",
        "abbrev": "BOS",
        "name": "Boston Celtics",
        "score": 106
      },
      "away": {
        "team_id": "6",
        "abbrev": "DAL",
        "name": "Dallas Mavericks",
        "score": 88
      },
      "periods": 4,
      "overtime_periods": 0,
      "neutral_site": false,
      "conference_game": false,
      "venue": "TD Garden",
      "city": "Boston",
      "attendance": 19156
    },
    {
      "game_id": "401656362",
      "season": 2024,
      "season_type": "postseason",
      "date": "2024-06-14",
      "starts_at": "2024-06-15T00:30:00.000Z",
      "status": "final",
      "home": {
        "team_id": "6",
        "abbrev": "DAL",
        "name": "Dallas Mavericks",
        "score": 122
      },
      "away": {
        "team_id": "2",
        "abbrev": "BOS",
        "name": "Boston Celtics",
        "score": 84
      },
      "periods": 4,
      "overtime_periods": 0,
      "neutral_site": false,
      "conference_game": false,
      "venue": "American Airlines Center",
      "city": "Dallas",
      "attendance": 20277
    },
    {
      "game_id": "401656361",
      "season": 2024,
      "season_type": "postseason",
      "date": "2024-06-12",
      "starts_at": "2024-06-13T00:30:00.000Z",
      "status": "final",
      "home": {
        "team_id": "6",
        "abbrev": "DAL",
        "name": "Dallas Mavericks",
        "score": 99
      },
      "away": {
        "team_id": "2",
        "abbrev": "BOS",
        "name": "Boston Celtics",
        "score": 106
      },
      "periods": 4,
      "overtime_periods": 0,
      "neutral_site": false,
      "conference_game": false,
      "venue": "American Airlines Center",
      "city": "Dallas",
      "attendance": 20311
    }
  ],
  "count": 3,
  "next_offset": 3
}