Skip to main content

BALLDONTLIE connector

Back to the connector overview, authentication methods, and actions.
2 Oct 2026
new-eventsAdded webhook support for the fourteen NBA event types — game started, ended, period ended and overtime; player scored, rebound, assist, steal, block, foul and turnover; and injury created, updated and cleared. Game events report the game as the record id, and player and injury events report the player. The webhook endpoint is created by hand in the BALLDONTLIE dashboard using the Native Webhook URL shown on the linked account, because managing webhooks over the API requires an ALL-ACCESS subscription. Only game started and game ended can be subscribed to on the Free plan. A catch-all handler acknowledges deliveries with no recognised NBA event type, including the dashboard’s test event, so endpoint verification succeeds and BALLDONTLIE does not auto-disable the endpoint. A setup guide walks through creating the endpoint in the BALLDONTLIE dashboard, with screenshots of each screen, and lists every event with its plan. Game started, game ended and the catch-all are verified against live deliveries and ship as preview; the twelve event types that need ALL-ACCESS could not be received on a Free account and ship as beta.
24 Sept 2026
new-feature data-syncTwelve list actions can now be synced with Data Sync, covering teams, players, active players, games, live box scores, stats, advanced stats, player injuries, betting odds, opening odds, DFS slates and DFS draftables. Every action runs as a full refresh, because the available date filters select when a game was played rather than when a record last changed.
balldontlie_get_all_active_players, balldontlie_get_all_advanced_stats_v2, balldontlie_get_all_games, balldontlie_get_all_player_injuries, balldontlie_get_all_players, balldontlie_get_all_stats, balldontlie_get_all_teams, balldontlie_get_betting_odds, balldontlie_get_live_box_scores, balldontlie_get_opening_betting_odds, balldontlie_list_dfs_draftables, balldontlie_list_dfs_slates
11 Sept 2026
releasePromoted to GA. Version normalized to 1.0.0 in line with the GA versioning policy (GA connectors are versioned 1.0.0 or higher); no functional changes in this version.
9 Sept 2026
guide-changesConnection guide fixes for the API Key setup. The guide now says the FREE tier is enough to link the account and lists which actions each NBA tier covers, describes the Try GOAT free for 48 hours banner and its Start trial button as separate from the SUBSCRIBE button on the plan cards, and adds the Change NBA Plan confirmation dialog and the Stripe payment form as their own steps. Tier prices render correctly again in the tier list.
8 Sept 2026
description-fixDescription accuracy pass on player search, team id provenance and game score attribution. The get_all_players and get_all_active_players actions now state that search takes a single name token matched as a case-insensitive substring of the first or last name, so a full “First Last” string returns nothing; first_name and last_name are documented as substring filters. Every team_ids input now says the values are the numeric ids returned by Get All Teams and are not derivable from names or abbreviations. The get_all_games and get_a_specific_game actions now spell out that a record’s home_* fields belong to its home_team object and visitor_* to visitor_team, with both team objects included in each record. The get_current_user action is described as the action for questions about the account’s own tier and subscriptions rather than a check to run before every data request, and every per_page description leads with the 1 to 100 range.
balldontlie_get_a_specific_game, balldontlie_get_all_active_players, balldontlie_get_all_advanced_stats_v2, balldontlie_get_all_games, balldontlie_get_all_player_injuries, balldontlie_get_all_players, balldontlie_get_all_stats, balldontlie_get_averages, balldontlie_get_betting_odds, balldontlie_get_current_user, balldontlie_get_game_lineups, balldontlie_get_opening_betting_odds, balldontlie_get_player_contracts, balldontlie_get_team_season_averages, balldontlie_list_dfs_draftables, balldontlie_list_dfs_slates
1 Sept 2026
new-connector new-actionsInitial action mappings for the BALLDONTLIE API — 29 read-only actions covering teams, players, games, box scores, play-by-play, player and team statistics, standings, leaders, injuries, contracts, betting odds, player props, and daily fantasy sports slates.