Basic lookup

List games

Use to list games with scores by season, date, date range or team, newest first. For upcoming games with lines use get_schedule; for one game's box score use get_game. Costs 2 credits.

post/v1/list_games

Request

  • Base URL: https://mcp.dunkapi.com
  • URL: https://mcp.dunkapi.com/v1/list_games
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

season_type'regular' | 'postseason' | 'play_in' | 'preseason'

regular, postseason, play_in or preseason.

teamstring

Team id or abbreviation.

datestring

One date, YYYY-MM-DD (US Eastern).

fromstring

From date, YYYY-MM-DD.

tostring

To date, YYYY-MM-DD.

status'scheduled' | 'final'
limitinteger

Max games (default 50).

offsetinteger

Page offset; use next_offset.

league'nba' | 'wnba' | 'ncaam' | 'ncaaw'

League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw.

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.