{"openapi":"3.1.0","info":{"title":"SportsData.io NBA (BYOK) API","version":"0.1.0","description":"SportsData.io NBA (BYOK) lets an AI assistant read your own SportsData.io NBA data through the SportsData.io NBA API with a key you supply (SportsData.io NBA API key). Read-only: 12 tools (get_standings, list_teams, get_season_schedule, list_games_by_date, get_current_season, list_team_players, list_team_season_stats, list_player_season_stats_by_team, list_team_game_stats_by_date, list_all_stars,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportsdataio-nba.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportsdataio-nba/docs"},"termsOfService":"https://connectorbay.com/byok-sportsdataio-nba/terms"},"servers":[{"url":"https://byok-sportsdataio-nba.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportsdataio-nba/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_standings":{"post":{"operationId":"get_standings","summary":"Get NBA standings for a season: wins, losses, conference and division record, home and away record, last ten games, poin","description":"Get NBA standings for a season: wins, losses, conference and division record, home and away record, last ten games, points per game, streak, games back and playoff flags. Use for \"What are the NBA standings this season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"get_standingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_teams":{"post":{"operationId":"list_teams","summary":"List active NBA teams with abbreviation, city, name, conference, division, stadium id and head coach. Use for \"Which con","description":"List active NBA teams with abbreviation, city, name, conference, division, stadium id and head coach. Use for \"Which conference and division is the Boston team in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_teamsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"Get a season's NBA game schedule with game ids, date, status, teams and scores for finished games. Use for \"Show the 202","description":"Get a season's NBA game schedule with game ids, date, status, teams and scores for finished games. Use for \"Show the 2026 NBA regular season schedule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year such as 2026, optionally followed by a season type: 2026PRE, 2026POST or 2026STAR (regular season when omitted).","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"get_season_scheduleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_games_by_date":{"post":{"operationId":"list_games_by_date","summary":"List NBA games on one date with status, quarter, time remaining, scores, TV channel and attendance; updates live during ","description":"List NBA games on one date with status, quarter, time remaining, scores, TV channel and attendance; updates live during games. Use for \"Which NBA games were on 2025-OCT-22 and what were the scores\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Game date written as YYYY-MON-DD with a three-letter month, for example 2025-OCT-22.","maxLength":11,"title":"Date","type":"string"}},"required":["date"],"title":"list_games_by_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_current_season":{"post":{"operationId":"get_current_season","summary":"Get the current NBA season: year, start and end year, description, regular season and postseason start dates, and the va","description":"Get the current NBA season: year, start and end year, description, regular season and postseason start dates, and the value to use as season in other tools. Use for \"What NBA season is current and when does the postseason start\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_current_seasonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_team_players":{"post":{"operationId":"list_team_players","summary":"List a team's NBA roster with name, jersey number, position, status, height, weight, college, experience and depth chart","description":"List a team's NBA roster with name, jersey number, position, status, height, weight, college, experience and depth chart position. Use for \"Who is on the Philadelphia roster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team":{"description":"Team abbreviation as returned by list_teams (Key), for example PHI or BKN.","maxLength":5,"title":"Team","type":"string"}},"required":["team"],"title":"list_team_playersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_team_season_stats":{"post":{"operationId":"list_team_season_stats","summary":"List season-total team statistics for all NBA teams: wins, losses, points, shooting percentages, rebounds, assists, stea","description":"List season-total team statistics for all NBA teams: wins, losses, points, shooting percentages, rebounds, assists, steals, blocks and turnovers. Use for \"Which NBA team scores the most points per game\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year such as 2026, optionally followed by a season type: 2026PRE, 2026POST or 2026STAR (regular season when omitted).","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"list_team_season_statsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_player_season_stats_by_team":{"post":{"operationId":"list_player_season_stats_by_team","summary":"List season-total player statistics for one NBA team: games, minutes, points, rebounds, assists, steals, blocks and shoo","description":"List season-total player statistics for one NBA team: games, minutes, points, rebounds, assists, steals, blocks and shooting percentages. Use for \"How many points per season did each Philadelphia player score\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year such as 2026, optionally followed by a season type: 2026PRE, 2026POST or 2026STAR (regular season when omitted).","maxLength":10,"title":"Season","type":"string"},"team":{"description":"Team abbreviation as returned by list_teams (Key), for example PHI or BKN.","maxLength":5,"title":"Team","type":"string"}},"required":["season","team"],"title":"list_player_season_stats_by_teamArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_team_game_stats_by_date":{"post":{"operationId":"list_team_game_stats_by_date","summary":"List team box score statistics for every NBA game on one date: opponent, home or away, points, shooting, rebounds, assis","description":"List team box score statistics for every NBA game on one date: opponent, home or away, points, shooting, rebounds, assists and turnovers. Use for \"How did each team shoot on 2025-OCT-22\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Game date written as YYYY-MON-DD with a three-letter month, for example 2025-OCT-22.","maxLength":11,"title":"Date","type":"string"}},"required":["date"],"title":"list_team_game_stats_by_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_all_stars":{"post":{"operationId":"list_all_stars","summary":"List players selected to the NBA All-Star game in a season with team and position. Use for \"Who were the 2026 NBA All-St","description":"List players selected to the NBA All-Star game in a season with team and position. Use for \"Who were the 2026 NBA All-Stars\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Season year, for example 2026.","maxLength":10,"title":"Season","type":"string"}},"required":["season"],"title":"list_all_starsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_stadiums":{"post":{"operationId":"list_stadiums","summary":"List NBA arenas with address, city, state, country, capacity, coordinates and active flag. Use for \"What is the capacity","description":"List NBA arenas with address, city, state, country, capacity, coordinates and active flag. Use for \"What is the capacity of each NBA arena\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_stadiumsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_transactions_by_date":{"post":{"operationId":"list_transactions_by_date","summary":"List NBA player signings, trades, waivers and releases recorded on one date. Use for \"Who was signed or waived in the NB","description":"List NBA player signings, trades, waivers and releases recorded on one date. Use for \"Who was signed or waived in the NBA on 2025-OCT-20\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"description":"Transaction date written as YYYY-MON-DD with a three-letter month, for example 2025-OCT-20.","maxLength":11,"title":"Date","type":"string"}},"required":["date"],"title":"list_transactions_by_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}