> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BALLDONTLIE

> How to set up the BALLDONTLIE connector, plus the actions and events that are available.

![BALLDONTLIE](https://stackone-logos.com/api/balldontlie/filled/svg)

v1.3.0[See changelog](https://docs.stackone.com/connectors/balldontlie/changelog.md)

[559 actions](#actions) · [15 events](#events) · 2 auth methods

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [MCP (API Key) · Connector Profile](https://docs.stackone.com/connectors/balldontlie/guides/connector-profile/mcp-api-key.md)
>
> Uses the same BALLDONTLIE API key as the REST API, sent as a bearer token to the remote MCP server at...

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/balldontlie/guides/connector-profile/api-key.md)
>
> Uses a personal API key sent as the raw value of the Authorization header. No app registration required. Keys are issued...

Optionally, configure receiving Events for BALLDONTLIE into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/balldontlie/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [MCP (API Key) · Link Account](https://docs.stackone.com/connectors/balldontlie/guides/link-account/mcp-api-key.md)

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/balldontlie/guides/link-account/api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Key

MCP (API Key)

No auth methods found

559 actions

ActionDescription

Get Current User`balldontlie_get_current_user`

Retrieve the authenticated account's profile, including email, overall tier, and per-sport subscription status.

Create A New Account`balldontlie_account_signup`

Create a new account Creates a new user account and returns the API key immediately. No authentication required. Securit...

Get Current User Profile`balldontlie_account_get_me`

Get current user profile Returns the authenticated user's profile including email, API key, tier, and subscriptions. Sec...

Rotate API Key`balldontlie_account_rotate_api_key`

Rotate API key Generates a new API key and invalidates the old one immediately. The response includes the new key. All s...

List Subscriptions`balldontlie_account_get_subscriptions`

List subscriptions Returns all subscriptions for the authenticated user, enriched with billing provider status when avai...

Create Or Change Subscription`balldontlie_account_change_subscription`

Create or change subscription Subscribe to a sport, upgrade, or downgrade your plan. If no payment method is on file, re...

Cancel Subscription`balldontlie_account_cancel_subscription`

Cancel subscription Cancel a subscription for a specific sport. Active subscriptions are scheduled for cancellation at t...

List All Available Plans`balldontlie_account_get_plans`

List all available plans Returns all available subscription plans with pricing, rate limits, and links to per-sport Open...

Get Plan For A Specific Sport`balldontlie_account_get_plans_by_sport`

Get plan for a specific sport Returns plan details for a single sport. No authentication required.

Generate Checkout URL`balldontlie_account_create_checkout`

Generate checkout URL Creates a hosted billing checkout session for a specific plan and returns the URL. A human must vi...

Get Billing Portal URL`balldontlie_account_get_billing_portal`

Get billing portal URL Generates a hosted billing portal URL where a human can update payment methods, view invoices, an...

Get ATP Players`balldontlie_atp_get_players`

Get ATP players Retrieve ATP tennis players with optional filters. Men's singles only. Free tier.

Get Specific ATP Player`balldontlie_atp_get_player`

Get specific ATP player Retrieve a single ATP player by ID. Free tier.

Get ATP Tournaments`balldontlie_atp_get_tournaments`

Get ATP tournaments Retrieve ATP tournaments with optional filters. Free tier.

Get Specific ATP Tournament`balldontlie_atp_get_tournament`

Get specific ATP tournament Retrieve a single ATP tournament by ID. Free tier.

Get ATP Rankings`balldontlie_atp_get_rankings`

Get ATP rankings Retrieve current ATP rankings. Free tier.

Get ATP Matches`balldontlie_atp_get_matches`

Get ATP matches Retrieve ATP matches with optional filters. Requires ALL-STAR tier.

Get Specific ATP Match`balldontlie_atp_get_match`

Get specific ATP match Retrieve a single ATP match by ID. Requires ALL-STAR tier.

Get ATP Race To Turin`balldontlie_atp_get_race`

Get ATP Race to Turin Retrieve ATP Race standings for season-ending ATP Finals qualification. Requires ALL-STAR tier.

Get ATP Match Statistics`balldontlie_atp_get_match_stats`

Get ATP match statistics Retrieve detailed match statistics. Requires GOAT tier.

Get ATP Player Career Statistics`balldontlie_atp_get_player_career_stats`

Get ATP player career statistics Retrieve career statistics for players. Requires GOAT tier.

Get ATP Head-to-head Record`balldontlie_atp_get_head_to_head`

Get ATP head-to-head record Retrieve head-to-head record between two players. Requires GOAT tier.

Get ATP Betting Odds`balldontlie_atp_get_odds`

Get ATP betting odds Retrieve betting odds for ATP matches. Requires at least one filter. Requires GOAT tier.

Get ATP Opening Betting Odds`balldontlie_atp_get_odds_opening`

Get ATP opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get Bundesliga Teams`balldontlie_bundesliga_get_teams`

Get Bundesliga teams Get all teams participating in the Bundesliga for a given season

Get Bundesliga Team Rosters`balldontlie_bundesliga_get_rosters`

Get Bundesliga team rosters Get player roster information for a specific team and season

Get Bundesliga Players`balldontlie_bundesliga_get_players`

Get Bundesliga players Get players with optional filtering by team or search term. Supports pagination.

Get Bundesliga Player Injuries`balldontlie_bundesliga_get_player_injuries`

Get Bundesliga player injuries Retrieve the current Bundesliga player injury snapshot. Supports filtering by player IDs,...

Get Bundesliga Standings`balldontlie_bundesliga_get_standings`

Get Bundesliga standings Get league standings for a specific season

Get Bundesliga Matches`balldontlie_bundesliga_get_matches`

Get Bundesliga matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get Bundesliga Match Events`balldontlie_bundesliga_get_match_events`

Get Bundesliga match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Sup...

Get Bundesliga Match Lineups`balldontlie_bundesliga_get_match_lineups`

Get Bundesliga match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Sup...

Get Bundesliga Player Match Statistics`balldontlie_bundesliga_get_player_match_stats`

Get Bundesliga player match statistics Get player match statistics with optional filtering by matches or players. Suppor...

Get Bundesliga Team Match Statistics`balldontlie_bundesliga_get_team_match_stats`

Get Bundesliga team match statistics Get team match statistics with optional filtering by matches or teams. Supports pag...

Get Bundesliga Betting Odds`balldontlie_bundesliga_get_betting_odds`

Get Bundesliga betting odds Retrieve betting odds for Bundesliga matches. Supports filtering by match IDs or dates. Bund...

Get Bundesliga Opening Betting Odds`balldontlie_bundesliga_get_odds_opening`

Get Bundesliga opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently c...

Get Bundesliga Player Prop Betting Odds`balldontlie_bundesliga_get_player_props`

Get Bundesliga player prop betting odds Retrieve live player prop betting data for Bundesliga matches. Player prop data...

Get Bundesliga Opening Player Prop Odds`balldontlie_bundesliga_get_odds_player_props_opening`

Get Bundesliga opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the...

Get Bundesliga Match Shots`balldontlie_bundesliga_get_match_shots`

Get Bundesliga match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available fo...

Get Bundesliga Match Attack Momentum`balldontlie_bundesliga_get_match_momentum`

Get Bundesliga match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, ne...

Get Bundesliga Match Top Performers`balldontlie_bundesliga_get_match_best_players`

Get Bundesliga match top performers Retrieve the top-rated players for each match (best XI per side and the man of the m...

Get Bundesliga Player Average Positions`balldontlie_bundesliga_get_match_avg_positions`

Get Bundesliga player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Co...

Get Bundesliga Player Heatmaps`balldontlie_bundesliga_get_match_heatmaps`

Get Bundesliga player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a matc...

Get Bundesliga Pre-match Team Form`balldontlie_bundesliga_get_match_pregame_forms`

Get Bundesliga pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league...

Get CBB Conferences`balldontlie_cbb_get_conferences`

Get CBB conferences

Get CBB Teams`balldontlie_cbb_get_teams`

Get CBB teams

Get CBB Players`balldontlie_cbb_get_players`

Get CBB players

Get CBB Team Standings`balldontlie_cbb_get_standings`

Get CBB team standings

Get CBB Games`balldontlie_cbb_get_games`

Get CBB games

Get CBB Rankings`balldontlie_cbb_get_rankings`

Get CBB rankings

Get Active CBB Players`balldontlie_cbb_get_active_players`

Get active CBB players

Get CBB Play-by-play Data`balldontlie_cbb_get_plays`

Get CBB play-by-play data

Get CBB Player Batting Statistics`balldontlie_cbb_get_player_batting_stats`

Get CBB player batting statistics

Get CBB Player Pitching Statistics`balldontlie_cbb_get_player_pitching_stats`

Get CBB player pitching statistics

Get CBB Team Batting Statistics`balldontlie_cbb_get_team_batting_stats`

Get CBB team batting statistics

Get CBB Team Pitching Statistics`balldontlie_cbb_get_team_pitching_stats`

Get CBB team pitching statistics

Get CBB Team Fielding Statistics`balldontlie_cbb_get_team_fielding_stats`

Get CBB team fielding statistics

Get CBB Player Season Batting Statistics`balldontlie_cbb_get_player_season_batting_stats`

Get CBB player season batting statistics

Get CBB Player Season Pitching Statistics`balldontlie_cbb_get_player_season_pitching_stats`

Get CBB player season pitching statistics

Get CBB Team Season Statistics`balldontlie_cbb_get_team_season_stats`

Get CBB team season statistics

Get CBB Betting Odds`balldontlie_cbb_get_odds`

Get CBB betting odds Retrieve betting odds for CBB games. Either dates or game\_ids is required.

Get CBB Opening Betting Odds`balldontlie_cbb_get_odds_opening`

Get CBB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get All CS2 Teams`balldontlie_cs2_get_teams`

Get all CS2 teams Retrieve a list of all professional Counter-Strike 2 teams

Get Specific CS2 Team`balldontlie_cs2_get_team_by_id`

Get specific CS2 team Retrieve details for a specific CS2 team

Get All CS2 Players`balldontlie_cs2_get_players`

Get all CS2 players Retrieve a list of all professional Counter-Strike 2 players

Get Specific CS2 Player`balldontlie_cs2_get_player_by_id`

Get specific CS2 player Retrieve details for a specific CS2 player

Get All CS2 Tournaments`balldontlie_cs2_get_tournaments`

Get all CS2 tournaments Retrieve a list of all Counter-Strike 2 tournaments

Get Specific CS2 Tournament`balldontlie_cs2_get_tournament_by_id`

Get specific CS2 tournament Retrieve details for a specific CS2 tournament

Get Tournament Teams`balldontlie_cs2_get_tournament_teams`

Get tournament teams Retrieve all teams participating in a specific CS2 tournament

Get Team Map Pool Stats`balldontlie_cs2_get_team_map_pool`

Get team map pool stats Retrieve map pool statistics for a specific CS2 team. Requires ALL-STAR tier or higher.

Get CS2 Team Rankings`balldontlie_cs2_get_rankings`

Get CS2 team rankings Retrieve current official CS2 team rankings based on the Valve World Rankings system. Requires ALL...

Get All CS2 Matches`balldontlie_cs2_get_matches`

Get all CS2 matches Retrieve a list of all CS2 matches with optional filtering. Requires GOAT tier.

Get Specific CS2 Match`balldontlie_cs2_get_match_by_id`

Get specific CS2 match Retrieve details for a specific CS2 match. Requires GOAT tier.

Get Match Maps`balldontlie_cs2_get_match_maps`

Get match maps Retrieve all maps (games) for specified CS2 matches. Requires GOAT tier.

Get Match Map Statistics`balldontlie_cs2_get_match_map_stats`

Get match map statistics Retrieve detailed round-by-round statistics for a specific map in a CS2 match. Requires GOAT ti...

Get Player Match Statistics`balldontlie_cs2_get_player_match_stats`

Get player match statistics Retrieve player statistics aggregated across all maps in a CS2 match. Requires GOAT tier.

Get Player Match Map Statistics`balldontlie_cs2_get_player_match_map_stats`

Get player match map statistics Retrieve player statistics for a specific map within a CS2 match. Requires GOAT tier.

Get Player Accuracy Statistics`balldontlie_cs2_get_player_accuracy_stats`

Get player accuracy statistics Retrieve accuracy statistics for a specific CS2 player, broken down by hit groups (body p...

Get All Dota 2 Teams`balldontlie_dota_get_teams`

Get all Dota 2 teams Retrieve a list of all professional Dota 2 teams

Get All Dota 2 Players`balldontlie_dota_get_players`

Get all Dota 2 players Retrieve a list of all professional Dota 2 players

Get All Dota 2 Heroes`balldontlie_dota_get_heroes`

Get all Dota 2 heroes Retrieve a list of all Dota 2 heroes

Get All Dota 2 Items`balldontlie_dota_get_items`

Get all Dota 2 items Retrieve a list of all Dota 2 in-game items

Get All Dota 2 Abilities`balldontlie_dota_get_abilities`

Get all Dota 2 abilities Retrieve a list of all Dota 2 hero abilities

Get Dota 2 Tournaments`balldontlie_dota_get_tournaments`

Get Dota 2 tournaments Retrieve a list of professional Dota 2 tournaments. Requires ALL-STAR tier or higher.

Get Teams In A Tournament`balldontlie_dota_get_tournament_teams`

Get teams in a tournament Retrieve teams participating in a specific Dota 2 tournament. Requires ALL-STAR tier or higher...

Get Tournament Roster`balldontlie_dota_get_tournament_roster`

Get tournament roster Retrieve player rosters for a Dota 2 tournament and team. Requires ALL-STAR tier or higher.

Get Hero Statistics`balldontlie_dota_get_hero_stats`

Get hero statistics Retrieve aggregate statistics for Dota 2 heroes across professional matches. Requires ALL-STAR tier...

Get Dota 2 Matches`balldontlie_dota_get_matches`

Get Dota 2 matches Retrieve professional Dota 2 matches. Requires GOAT tier.

Get Match Maps (games)`balldontlie_dota_get_match_maps`

Get match maps (games) Retrieve individual games within a Dota 2 match. Requires GOAT tier.

Get Player Match Map Statistics`balldontlie_dota_get_player_match_map_stats`

Get player match map statistics Retrieve detailed player statistics for individual Dota 2 games. Requires GOAT tier.

Get Team Match Map Statistics`balldontlie_dota_get_team_match_map_stats`

Get team match map statistics Retrieve detailed team statistics for individual Dota 2 games. Requires GOAT tier.

Get Player Overall Statistics`balldontlie_dota_get_player_overall_stats`

Get player overall statistics Retrieve career statistics for Dota 2 players. Requires GOAT tier.

Get EPL Teams`balldontlie_epl_v2_get_teams`

Get EPL teams Get all teams participating in the English Premier League for a given season

Get EPL Team Rosters`balldontlie_epl_v2_get_rosters`

Get EPL team rosters Get player roster information for a specific team and season

Get EPL Players`balldontlie_epl_v2_get_players`

Get EPL players Get players with optional filtering by team or search term. Supports pagination.

Get EPL Player Injuries`balldontlie_epl_v2_get_player_injuries`

Get EPL player injuries Retrieve the current EPL player injury snapshot. Supports filtering by player IDs, team IDs, or...

Get EPL Standings`balldontlie_epl_v2_get_standings`

Get EPL standings Get league standings for a specific season

Get EPL Matches`balldontlie_epl_v2_get_matches`

Get EPL matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get EPL Match Events`balldontlie_epl_v2_get_match_events`

Get EPL match events Get events (goals, cards, substitutions) for matches. Supports pagination.

Get EPL Match Lineups`balldontlie_epl_v2_get_match_lineups`

Get EPL match lineups Get player lineups for matches. Supports pagination.

Get EPL Player Match Statistics`balldontlie_epl_v2_get_player_match_stats`

Get EPL player match statistics Get individual player statistics for matches. Supports pagination.

Get EPL Team Match Statistics`balldontlie_epl_v2_get_team_match_stats`

Get EPL team match statistics Get team-level statistics for matches. Supports pagination.

Get EPL Betting Odds`balldontlie_epl_v2_get_betting_odds`

Get EPL betting odds Get betting odds for EPL matches. Filter by match IDs or dates. Supports pagination.

Get EPL Opening Betting Odds`balldontlie_epl_v2_get_odds_opening`

Get EPL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get EPL Player Prop Betting Odds`balldontlie_epl_v2_get_player_props`

Get EPL player prop betting odds Retrieve live player prop betting data for EPL matches. Player prop data is LIVE and up...

Get EPL Opening Player Prop Odds`balldontlie_epl_v2_get_odds_player_props_opening`

Get EPL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get EPL Match Shots`balldontlie_epl_v2_get_match_shots`

Get EPL match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for match...

Get EPL Match Attack Momentum`balldontlie_epl_v2_get_match_momentum`

Get EPL match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative...

Get EPL Match Top Performers`balldontlie_epl_v2_get_match_best_players`

Get EPL match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match)....

Get EPL Player Average Positions`balldontlie_epl_v2_get_match_avg_positions`

Get EPL player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinat...

Get EPL Player Heatmaps`balldontlie_epl_v2_get_match_heatmaps`

Get EPL player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concl...

Get EPL Pre-match Team Form`balldontlie_epl_v2_get_match_pregame_forms`

Get EPL pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league positio...

Get F1 Drivers`balldontlie_f1_get_drivers`

Get F1 drivers Retrieve a list of Formula 1 drivers with optional filtering. FREE tier.

Get F1 Teams`balldontlie_f1_get_teams`

Get F1 teams Retrieve a list of Formula 1 teams with optional filtering. FREE tier.

Get F1 Circuits`balldontlie_f1_get_circuits`

Get F1 circuits Retrieve a list of Formula 1 circuits with optional filtering. FREE tier.

Get F1 Seasons`balldontlie_f1_get_seasons`

Get F1 seasons Retrieve a list of Formula 1 seasons. FREE tier.

Get F1 Events`balldontlie_f1_get_events`

Get F1 events Retrieve a list of Formula 1 race events (Grand Prix weekends) with optional filtering. FREE tier.

Get F1 Sessions`balldontlie_f1_get_sessions`

Get F1 sessions Retrieve a list of Formula 1 sessions (Practice, Qualifying, Sprint, Race) with optional filtering. Requ...

Get F1 Session Results`balldontlie_f1_get_session_results`

Get F1 session results Retrieve Formula 1 session results (finishing positions, laps completed, etc.) with optional filt...

Get F1 Driver Standings`balldontlie_f1_get_driver_standings`

Get F1 driver standings Retrieve Formula 1 Driver Championship standings for a specific season. Requires PAID tier or hi...

Get F1 Team Standings`balldontlie_f1_get_team_standings`

Get F1 team standings Retrieve Formula 1 Constructors Championship standings for a specific season. Requires PAID tier o...

Get F1 Lap Times`balldontlie_f1_get_lap_times`

Get F1 lap times Retrieve detailed lap-by-lap timing data for Formula 1 sessions. Requires PAID+ tier.

Get F1 Qualifying Results`balldontlie_f1_get_qualifying_results`

Get F1 qualifying results Retrieve detailed qualifying session results including Q1, Q2, and Q3 times. Requires PAID+ ti...

Get F1 Pit Stops`balldontlie_f1_get_pit_stops`

Get F1 pit stops Retrieve pit stop data including duration and timing. Requires PAID+ tier.

Get F1 Tire Stints`balldontlie_f1_get_tire_stints`

Get F1 tire stints Retrieve tire compound and stint data for each driver. Requires PAID+ tier.

Get F1 Session Weather`balldontlie_f1_get_session_weather`

Get F1 session weather Retrieve weather conditions during Formula 1 sessions. Requires PAID+ tier.

Get F1 Race Control Messages`balldontlie_f1_get_race_control_messages`

Get F1 race control messages Retrieve race control messages including flags, safety car, and DRS notifications. Requires...

Get F1 Position History`balldontlie_f1_get_position_history`

Get F1 position history Retrieve lap-by-lap position changes for drivers during sessions. Requires PAID+ tier.

Get F1 Session Timing Stats`balldontlie_f1_get_session_timing_stats`

Get F1 session timing stats Retrieve detailed timing statistics including best laps, sector times, and speed trap data....

Get F1 Track Status`balldontlie_f1_get_track_status`

Get F1 track status Retrieve track status changes during sessions (green flag, yellow flag, safety car, etc.). Requires...

Get F1 Futures Odds`balldontlie_f1_get_futures_odds`

Get F1 futures odds Retrieve futures betting odds for Formula 1 championships (e.g., driver championship winner, constru...

Get FIFA World Cup Teams`balldontlie_fifa_get_teams`

Get FIFA World Cup teams Retrieve participating nations for the requested World Cup edition(s). Defaults to 2026 when se...

Get FIFA World Cup Stadiums`balldontlie_fifa_get_stadiums`

Get FIFA World Cup stadiums Retrieve host stadiums used by the requested World Cup edition(s). Defaults to 2026 when sea...

Get FIFA World Cup Group Standings`balldontlie_fifa_get_group_standings`

Get FIFA World Cup group standings Retrieve group stage standings for the requested World Cup edition(s). Defaults to 20...

Get FIFA World Cup Matches`balldontlie_fifa_get_matches`

Get FIFA World Cup matches Retrieve matches for the requested World Cup edition(s). Cursor-paginated. Requires GOAT tier...

Get FIFA World Cup Betting Odds`balldontlie_fifa_get_betting_odds`

Get FIFA World Cup betting odds Retrieve moneyline, spread, total, and additional match betting markets for World Cup ma...

Get FIFA Opening Betting Odds`balldontlie_fifa_get_odds_opening`

Get FIFA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complet...

Get FIFA World Cup Futures Odds`balldontlie_fifa_get_futures_odds`

Get FIFA World Cup futures odds Retrieve futures betting odds for the FIFA World Cup. Defaults to 2026 when seasons\[] is...

Get FIFA World Cup Player Prop Betting Odds`balldontlie_fifa_get_odds_player_props`

Get FIFA World Cup player prop betting odds Retrieve live player prop betting data for FIFA World Cup matches. Player pr...

Get FIFA Opening Player Prop Odds`balldontlie_fifa_get_odds_player_props_opening`

Get FIFA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most...

Get FIFA World Cup Players`balldontlie_fifa_get_players`

Get FIFA World Cup players Retrieve biographical data for players who have appeared in any World Cup squad. When \`season...

Get FIFA World Cup Player Injuries`balldontlie_fifa_get_player_injuries`

Get FIFA World Cup player injuries Retrieve the current FIFA World Cup player injury snapshot. Supports filtering by Wor...

Get FIFA World Cup Tournament Rosters`balldontlie_fifa_get_rosters`

Get FIFA World Cup tournament rosters Retrieve per-tournament squad entries with cumulative tournament stats. When \`seas...

Get FIFA World Cup Match Lineups`balldontlie_fifa_get_match_lineups`

Get FIFA World Cup match lineups Retrieve registered match-day squads (starters + substitutes). Requires GOAT tier.

Get FIFA World Cup Match Events`balldontlie_fifa_get_match_events`

Get FIFA World Cup match events Retrieve time-ordered match incidents (goals, cards, substitutions, period markers, shoo...

Get FIFA World Cup Player Match Stats`balldontlie_fifa_get_player_match_stats`

Get FIFA World Cup player match stats Retrieve per-player per-match performance stats. Requires GOAT tier.

Get FIFA World Cup Team Match Stats`balldontlie_fifa_get_team_match_stats`

Get FIFA World Cup team match stats Retrieve per-team per-match aggregates. Requires GOAT tier.

Get FIFA World Cup Match Shots`balldontlie_fifa_get_match_shots`

Get FIFA World Cup match shots Retrieve shot-map entries with xG / xGoT and pitch coordinates. Requires GOAT tier.

Get FIFA World Cup Match Attack Momentum`balldontlie_fifa_get_match_momentum`

Get FIFA World Cup match attack momentum Retrieve per-minute attack momentum values. Requires GOAT tier.

Get FIFA World Cup Match Top Performers`balldontlie_fifa_get_match_best_players`

Get FIFA World Cup match top performers Retrieve the top-rated players for each match (best XI per side and the man of t...

Get FIFA World Cup Player Average Positions`balldontlie_fifa_get_match_avg_positions`

Get FIFA World Cup player average positions Retrieve each player's average pitch position (heatmap centroid) for a match...

Get FIFA World Cup Pre-match Team Form`balldontlie_fifa_get_match_team_form`

Get FIFA World Cup pre-match team form Retrieve a pre-match team form summary (recent average rating, position, and a fi...

Get La Liga Teams`balldontlie_laliga_get_teams`

Get La Liga teams Get all teams participating in La Liga for a given season

Get La Liga Team Rosters`balldontlie_laliga_get_rosters`

Get La Liga team rosters Get player roster information for a specific team and season

Get La Liga Players`balldontlie_laliga_get_players`

Get La Liga players Get players with optional filtering by team or search term. Supports pagination.

Get La Liga Player Injuries`balldontlie_laliga_get_player_injuries`

Get La Liga player injuries Retrieve the current La Liga player injury snapshot. Supports filtering by player IDs, team...

Get La Liga Standings`balldontlie_laliga_get_standings`

Get La Liga standings Get league standings for a specific season

Get La Liga Matches`balldontlie_laliga_get_matches`

Get La Liga matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get La Liga Match Events`balldontlie_laliga_get_match_events`

Get La Liga match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Suppor...

Get La Liga Match Lineups`balldontlie_laliga_get_match_lineups`

Get La Liga match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Suppor...

Get La Liga Player Match Statistics`balldontlie_laliga_get_player_match_stats`

Get La Liga player match statistics Get player match statistics with optional filtering by matches or players. Supports...

Get La Liga Team Match Statistics`balldontlie_laliga_get_team_match_stats`

Get La Liga team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagina...

Get La Liga Betting Odds`balldontlie_laliga_get_betting_odds`

Get La Liga betting odds Retrieve betting odds for La Liga matches. Supports filtering by match IDs or dates. La Liga od...

Get La Liga Opening Betting Odds`balldontlie_laliga_get_odds_opening`

Get La Liga opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently comp...

Get La Liga Player Prop Betting Odds`balldontlie_laliga_get_player_props`

Get La Liga player prop betting odds Retrieve live player prop betting data for La Liga matches. Player prop data is LIV...

Get La Liga Opening Player Prop Odds`balldontlie_laliga_get_odds_player_props_opening`

Get La Liga opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the mo...

Get La Liga Match Shots`balldontlie_laliga_get_match_shots`

Get La Liga match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for m...

Get La Liga Match Attack Momentum`balldontlie_laliga_get_match_momentum`

Get La Liga match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negat...

Get La Liga Match Top Performers`balldontlie_laliga_get_match_best_players`

Get La Liga match top performers Retrieve the top-rated players for each match (best XI per side and the man of the matc...

Get La Liga Player Average Positions`balldontlie_laliga_get_match_avg_positions`

Get La Liga player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coord...

Get La Liga Player Heatmaps`balldontlie_laliga_get_match_heatmaps`

Get La Liga player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match c...

Get La Liga Pre-match Team Form`balldontlie_laliga_get_match_pregame_forms`

Get La Liga pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league pos...

Get Ligue 1 Teams`balldontlie_ligue1_get_teams`

Get Ligue 1 teams Get all teams participating in Ligue 1 for a given season

Get Ligue 1 Team Rosters`balldontlie_ligue1_get_rosters`

Get Ligue 1 team rosters Get player roster information for a specific team and season

Get Ligue 1 Players`balldontlie_ligue1_get_players`

Get Ligue 1 players Get players with optional filtering by team or search term. Supports pagination.

Get Ligue 1 Player Injuries`balldontlie_ligue1_get_player_injuries`

Get Ligue 1 player injuries Retrieve the current Ligue 1 player injury snapshot. Supports filtering by player IDs, team...

Get Ligue 1 Standings`balldontlie_ligue1_get_standings`

Get Ligue 1 standings Get league standings for a specific season

Get Ligue 1 Matches`balldontlie_ligue1_get_matches`

Get Ligue 1 matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get Ligue 1 Match Events`balldontlie_ligue1_get_match_events`

Get Ligue 1 match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Suppor...

Get Ligue 1 Match Lineups`balldontlie_ligue1_get_match_lineups`

Get Ligue 1 match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Suppor...

Get Ligue 1 Player Match Statistics`balldontlie_ligue1_get_player_match_stats`

Get Ligue 1 player match statistics Get player match statistics with optional filtering by matches or players. Supports...

Get Ligue 1 Team Match Statistics`balldontlie_ligue1_get_team_match_stats`

Get Ligue 1 team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagina...

Get Ligue 1 Betting Odds`balldontlie_ligue1_get_betting_odds`

Get Ligue 1 betting odds Retrieve betting odds for Ligue 1 matches. Supports filtering by match IDs or dates. Ligue 1 od...

Get Ligue 1 Opening Betting Odds`balldontlie_ligue1_get_odds_opening`

Get Ligue 1 opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently comp...

Get Ligue 1 Player Prop Betting Odds`balldontlie_ligue1_get_player_props`

Get Ligue 1 player prop betting odds Retrieve live player prop betting data for Ligue 1 matches. Player prop data is LIV...

Get Ligue 1 Opening Player Prop Odds`balldontlie_ligue1_get_odds_player_props_opening`

Get Ligue 1 opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the mo...

Get Ligue 1 Match Shots`balldontlie_ligue1_get_match_shots`

Get Ligue 1 match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for m...

Get Ligue 1 Match Attack Momentum`balldontlie_ligue1_get_match_momentum`

Get Ligue 1 match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negat...

Get Ligue 1 Match Top Performers`balldontlie_ligue1_get_match_best_players`

Get Ligue 1 match top performers Retrieve the top-rated players for each match (best XI per side and the man of the matc...

Get Ligue 1 Player Average Positions`balldontlie_ligue1_get_match_avg_positions`

Get Ligue 1 player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coord...

Get Ligue 1 Player Heatmaps`balldontlie_ligue1_get_match_heatmaps`

Get Ligue 1 player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match c...

Get Ligue 1 Pre-match Team Form`balldontlie_ligue1_get_match_pregame_forms`

Get Ligue 1 pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league pos...

Get All LOL Teams`balldontlie_lol_get_teams`

Get all LOL teams Retrieve a list of all professional League of Legends teams

Get All LOL Players`balldontlie_lol_get_players`

Get all LOL players Retrieve a list of all professional League of Legends players

Get All LOL Champions`balldontlie_lol_get_champions`

Get all LOL champions Retrieve a list of all League of Legends champions

Get All LOL Items`balldontlie_lol_get_items`

Get all LOL items Retrieve a list of all League of Legends in-game items

Get All LOL Summoner Spells`balldontlie_lol_get_spells`

Get all LOL summoner spells Retrieve a list of all League of Legends summoner spells

Get All LOL Rune Paths`balldontlie_lol_get_rune_paths`

Get all LOL rune paths Retrieve a list of all League of Legends rune paths (Domination, Inspiration, Precision, Resolve,...

Get All LOL Runes`balldontlie_lol_get_runes`

Get all LOL runes Retrieve a list of all League of Legends runes with their paths and types

Get LOL Tournaments`balldontlie_lol_get_tournaments`

Get LOL tournaments Retrieve a list of professional League of Legends tournaments. Requires ALL-STAR tier or higher.

Get Teams In A Tournament`balldontlie_lol_get_tournament_teams`

Get teams in a tournament Retrieve teams participating in a specific tournament. Requires ALL-STAR tier or higher.

Get Tournament Roster`balldontlie_lol_get_tournament_roster`

Get tournament roster Retrieve player rosters for a tournament and team. Requires ALL-STAR tier or higher.

Get Champion Statistics`balldontlie_lol_get_champion_stats`

Get champion statistics Retrieve aggregate statistics for LOL champions across professional matches. Requires ALL-STAR t...

Get LOL Matches`balldontlie_lol_get_matches`

Get LOL matches Retrieve professional League of Legends matches. Requires GOAT tier.

Get Match Maps (games)`balldontlie_lol_get_match_maps`

Get match maps (games) Retrieve individual games within a match. Requires GOAT tier.

Get Player Match Map Statistics`balldontlie_lol_get_player_match_map_stats`

Get player match map statistics Retrieve detailed player statistics for individual games. Requires GOAT tier.

Get Team Match Map Statistics`balldontlie_lol_get_team_match_map_stats`

Get team match map statistics Retrieve detailed team statistics for individual games. Requires GOAT tier.

Get Player Overall Statistics`balldontlie_lol_get_player_overall_stats`

Get player overall statistics Retrieve career statistics for LOL players. Requires GOAT tier.

Get MLB Teams`balldontlie_mlb_get_teams`

Get MLB teams

Get Specific MLB Team`balldontlie_mlb_get_team_by_id`

Get specific MLB team

Get MLB Players`balldontlie_mlb_get_players`

Get MLB players

Get Specific MLB Player`balldontlie_mlb_get_player_by_id`

Get specific MLB player

Get MLB Player Injuries`balldontlie_mlb_get_player_injuries`

Get MLB player injuries

Get Active MLB Players`balldontlie_mlb_get_active_players`

Get active MLB players

Get MLB Games`balldontlie_mlb_get_games`

Get MLB games

Get Specific MLB Game`balldontlie_mlb_get_game_by_id`

Get specific MLB game

Get MLB Stats`balldontlie_mlb_get_stats`

Get MLB stats

Get MLB Team Standings`balldontlie_mlb_get_standings`

Get MLB team standings

Get MLB Season Stats`balldontlie_mlb_get_season_stats`

Get MLB season stats

Get MLB Team Season Stats`balldontlie_mlb_get_team_season_stats`

Get MLB team season stats

Get MLB Player Splits`balldontlie_mlb_get_player_splits`

Get MLB player splits Get player splits grouped by split\_category (e.g., vs RHP/LHP, by month, by opponent, etc.)

Get MLB Player Vs Player Matchups`balldontlie_mlb_get_player_versus`

Get MLB player vs player matchups Get head-to-head batting statistics for batter against pitchers for a specific team, o...

Get MLB Play-by-play Data`balldontlie_mlb_get_plays`

Get MLB play-by-play data Returns play-by-play data for a specific game including game state, scoring plays, and batted...

Get MLB Plate Appearance Data`balldontlie_mlb_get_plate_appearances`

Get MLB plate appearance data Returns plate appearance data for a specific game. Each plate appearance includes the outc...

Get MLB Pitcher Pitch Type Game Stats`balldontlie_mlb_get_pitcher_pitch_type_game_stats`

Get MLB pitcher pitch type game stats Returns per-game pitcher pitch-type usage, command, whiff/contact, and damage metr...

Get MLB Hitter Pitch Type Game Stats`balldontlie_mlb_get_hitter_pitch_type_game_stats`

Get MLB hitter pitch type game stats Returns per-game hitter pitch-type usage, command, whiff/contact, and damage metric...

Get MLB Pitcher Pitch Type Season Stats`balldontlie_mlb_get_pitcher_pitch_type_season_stats`

Get MLB pitcher pitch type season stats Returns season-level pitcher pitch-type usage, command, whiff/contact, and damag...

Get MLB Hitter Pitch Type Season Stats`balldontlie_mlb_get_hitter_pitch_type_season_stats`

Get MLB hitter pitch type season stats Returns season-level hitter pitch-type usage, command, whiff/contact, and damage...

Get MLB Betting Odds`balldontlie_mlb_get_odds`

Get MLB betting odds Retrieve betting odds for MLB games. Either dates or game\_ids is required.

Get All Current MLB Betting Markets`balldontlie_mlb_get_odds_markets`

Get all current MLB betting markets Retrieve the current market catalog for one MLB game. This open-ended endpoint inclu...

Get MLB Opening Betting Odds`balldontlie_mlb_get_odds_opening`

Get MLB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get MLB Player Prop Betting Odds`balldontlie_mlb_get_player_props`

Get MLB player prop betting odds Retrieve live player prop betting data for MLB games. Player prop data is LIVE and upda...

Get MLB Opening Player Prop Odds`balldontlie_mlb_get_odds_player_props_opening`

Get MLB opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get MLB DFS Slates`balldontlie_mlb_get_dfs_slates`

Get MLB DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event w\...

Get A MLB DFS Slate`balldontlie_mlb_get_dfs_slates_by_id`

Get a MLB DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game\_id values u...

Get MLB DFS Draftables`balldontlie_mlb_get_dfs_draftables`

Get MLB DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary...

Get MLB Game Lineups`balldontlie_mlb_get_lineups`

Get MLB game lineups Get pre-game batting lineups and probable pitchers for MLB games. Lineups typically appear 1-2 hour...

Get MLS Teams`balldontlie_mls_get_teams`

Get MLS teams Get all teams participating in MLS for a given season

Get MLS Team Rosters`balldontlie_mls_get_rosters`

Get MLS team rosters Get player roster information for a specific team and season

Get MLS Players`balldontlie_mls_get_players`

Get MLS players Get players with optional filtering by team or search term. Supports pagination.

Get MLS Player Injuries`balldontlie_mls_get_player_injuries`

Get MLS player injuries Retrieve the current MLS player injury snapshot. Supports filtering by player IDs, team IDs, or...

Get MLS Standings`balldontlie_mls_get_standings`

Get MLS standings Get league standings for a specific season. MLS uses conference-based standings (Eastern and Western C...

Get MLS Matches`balldontlie_mls_get_matches`

Get MLS matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get MLS Match Events`balldontlie_mls_get_match_events`

Get MLS match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports p...

Get MLS Match Lineups`balldontlie_mls_get_match_lineups`

Get MLS match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports p...

Get MLS Player Match Statistics`balldontlie_mls_get_player_match_stats`

Get MLS player match statistics Get player match statistics with optional filtering by matches or players. Supports pagi...

Get MLS Team Match Statistics`balldontlie_mls_get_team_match_stats`

Get MLS team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination...

Get MLS Betting Odds`balldontlie_mls_get_betting_odds`

Get MLS betting odds Retrieve betting odds for MLS matches. Supports filtering by match IDs or dates. MLS odds include m...

Get MLS Opening Betting Odds`balldontlie_mls_get_odds_opening`

Get MLS opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get MLS Player Prop Betting Odds`balldontlie_mls_get_player_props`

Get MLS player prop betting odds Retrieve live player prop betting data for MLS matches. Player prop data is LIVE and up...

Get MLS Opening Player Prop Odds`balldontlie_mls_get_odds_player_props_opening`

Get MLS opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get MLS Match Shots`balldontlie_mls_get_match_shots`

Get MLS match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for match...

Get MLS Match Attack Momentum`balldontlie_mls_get_match_momentum`

Get MLS match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative...

Get MLS Match Top Performers`balldontlie_mls_get_match_best_players`

Get MLS match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match)....

Get MLS Player Average Positions`balldontlie_mls_get_match_avg_positions`

Get MLS player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinat...

Get MLS Player Heatmaps`balldontlie_mls_get_match_heatmaps`

Get MLS player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concl...

Get MLS Pre-match Team Form`balldontlie_mls_get_match_pregame_forms`

Get MLS pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league positio...

Get All MMA Leagues`balldontlie_mma_get_leagues`

Get all MMA leagues Retrieve a list of all MMA leagues. Note: UFC is the only league with comprehensive coverage.

Get Specific MMA League`balldontlie_mma_get_league_by_id`

Get specific MMA league Retrieve details for a specific MMA league

Get MMA Events`balldontlie_mma_get_events`

Get MMA events Retrieve a list of MMA events with optional filtering

Get Specific MMA Event`balldontlie_mma_get_event_by_id`

Get specific MMA event Retrieve metadata for a specific MMA event. Fights are not embedded; retrieve the paginated card...

Get MMA Fighters`balldontlie_mma_get_fighters`

Get MMA fighters Retrieve a list of MMA fighters with optional search and filtering

Get Specific MMA Fighter`balldontlie_mma_get_fighter_by_id`

Get specific MMA fighter Retrieve details for a specific MMA fighter

Get MMA Fights`balldontlie_mma_get_fights`

Get MMA fights Retrieve a list of MMA fights with optional filtering

Get Specific MMA Fight`balldontlie_mma_get_fight_by_id`

Get specific MMA fight Retrieve details for a specific MMA fight

Get MMA Rankings`balldontlie_mma_get_rankings`

Get MMA rankings Retrieve all current fighter rankings grouped by weight class and league. This endpoint does not suppor...

Get MMA Fight Statistics`balldontlie_mma_get_fight_stats`

Get MMA fight statistics Retrieve detailed fight statistics for fighters

Get Specific Fight Statistics`balldontlie_mma_get_fight_stat_by_id`

Get specific fight statistics Retrieve statistics for a specific fight performance

Get MMA Betting Odds`balldontlie_mma_get_betting_odds`

Get MMA betting odds Retrieve betting odds for MMA fights. Either event\_id or fight\_id is required.

Get MMA Opening Betting Odds`balldontlie_mma_get_odds_opening`

Get MMA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get NBA Teams`balldontlie_nba_get_teams`

Get NBA teams

Get Specific NBA Team`balldontlie_nba_get_team_by_id`

Get specific NBA team

Get NBA Players`balldontlie_nba_get_players`

Get NBA players

Get Specific NBA Player`balldontlie_nba_get_player_by_id`

Get specific NBA player

Get NBA Games`balldontlie_nba_get_games`

Get NBA games

Get Specific NBA Game`balldontlie_nba_get_game_by_id`

Get specific NBA game

Get NBA Stats`balldontlie_nba_get_stats`

Get NBA stats

Get NBA Season Averages`balldontlie_nba_get_simple_season_averages`

Get NBA season averages

Get NBA Season Averages By Type`balldontlie_nba_get_season_averages`

Get NBA season averages by type

Get NBA Team Season Averages By Category`balldontlie_nba_get_team_season_averages`

Get NBA team season averages by category Retrieve team season averages for various statistical categories. Each category...

Get NBA Team Standings`balldontlie_nba_get_standings`

Get NBA team standings

Get Active NBA Players`balldontlie_nba_get_active_players`

Get active NBA players

Get NBA Player Injuries`balldontlie_nba_get_player_injuries`

Get NBA player injuries

Get Live NBA Box Scores`balldontlie_nba_get_live_box_scores`

Get live NBA box scores

Get NBA Box Scores For A Specific Date`balldontlie_nba_get_box_scores`

Get NBA box scores for a specific date

Get NBA Game Lineups`balldontlie_nba_get_lineups`

Get NBA game lineups Retrieve starting lineups and bench players for NBA games. \*\*Important Notes:\*\* - Lineup data is on...

Get NBA Stat Leaders`balldontlie_nba_get_leaders`

Get NBA stat leaders

Get NBA Betting Odds`balldontlie_nba_get_betting_odds`

Get NBA betting odds Retrieve betting odds for NBA games, including preseason games when odds are available. Either date...

Get NBA Opening Betting Odds`balldontlie_nba_get_odds_opening`

Get NBA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get NBA Player Prop Betting Odds`balldontlie_nba_get_player_props`

Get NBA player prop betting odds Retrieve live player prop betting data for NBA games. Player prop data is LIVE and upda...

Get NBA Opening Player Prop Odds`balldontlie_nba_get_odds_player_props_opening`

Get NBA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get NBA Advanced Stats (V2)`balldontlie_nba_get_advanced_stats_v2`

Get NBA advanced stats (V2) Retrieve comprehensive advanced statistics for NBA player performances. This V2 endpoint inc...

Get NBA Player Contracts By Team`balldontlie_nba_get_contracts_by_team`

Get NBA player contracts by team Returns all player contracts for a specific team and season. Season defaults to current...

Get NBA Player Contracts`balldontlie_nba_get_contracts_by_player`

Get NBA player contracts Returns contracts for a specific player, optionally filtered by seasons. Supports pagination.

Get Aggregated NBA Player Contract Data`balldontlie_nba_get_contracts_aggregate`

Get aggregated NBA player contract data Returns multi-year contract aggregates for a specific player, including total va...

Get NBA DFS Slates`balldontlie_nba_get_dfs_slates`

Get NBA DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event w\...

Get A NBA DFS Slate`balldontlie_nba_get_dfs_slates_by_id`

Get a NBA DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game\_id values u...

Get NBA DFS Draftables`balldontlie_nba_get_dfs_draftables`

Get NBA DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary...

Get NBA Play-by-play Data`balldontlie_nba_get_plays`

Get NBA play-by-play data Retrieve play-by-play data for an NBA game. Returns all plays for a game in chronological orde...

Get NCAAB Conferences`balldontlie_ncaab_get_conferences`

Get NCAAB conferences

Get Specific NCAAB Conference`balldontlie_ncaab_get_conference_by_id`

Get specific NCAAB conference

Get NCAAB Teams`balldontlie_ncaab_get_teams`

Get NCAAB teams

Get Specific NCAAB Team`balldontlie_ncaab_get_team_by_id`

Get specific NCAAB team

Get NCAAB Players`balldontlie_ncaab_get_players`

Get NCAAB players

Get Specific NCAAB Player`balldontlie_ncaab_get_player_by_id`

Get specific NCAAB player

Get Active NCAAB Players`balldontlie_ncaab_get_active_players`

Get active NCAAB players

Get NCAAB Team Standings`balldontlie_ncaab_get_standings`

Get NCAAB team standings Get team standings. Note - season values are transformed (user sends 2025, API queries DB for 2...

Get NCAAB Games`balldontlie_ncaab_get_games`

Get NCAAB games Get games. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get Specific NCAAB Game`balldontlie_ncaab_get_game_by_id`

Get specific NCAAB game

Get NCAAB Rankings`balldontlie_ncaab_get_rankings`

Get NCAAB rankings Get team rankings. Note - season values are transformed (user sends 2025, API queries DB for 2026, re...

Get NCAAB Play-by-play Data`balldontlie_ncaab_get_plays`

Get NCAAB play-by-play data

Get NCAAB Player Game Statistics`balldontlie_ncaab_get_player_stats`

Get NCAAB player game statistics Get player statistics. Note - season values are transformed (user sends 2025, API queri...

Get NCAAB Team Game Statistics`balldontlie_ncaab_get_team_stats`

Get NCAAB team game statistics Get team statistics. Note - season values are transformed (user sends 2025, API queries D...

Get NCAAB Player Season Statistics`balldontlie_ncaab_get_player_season_stats`

Get NCAAB player season statistics Get player season averages. Note - season values are transformed (user sends 2025, AP...

Get NCAAB Team Season Statistics`balldontlie_ncaab_get_team_season_stats`

Get NCAAB team season statistics Get team season averages. Note - season values are transformed (user sends 2025, API qu...

Get NCAAB Tournament Bracket Data`balldontlie_ncaab_get_brackets`

Get NCAAB tournament bracket data Retrieve NCAA Men's Basketball tournament bracket data with optional filters (GOAT tie...

Get NCAAB Betting Odds`balldontlie_ncaab_get_betting_odds`

Get NCAAB betting odds Retrieve betting odds for NCAAB games. Either dates or game\_ids is required.

Get NCAAB Opening Betting Odds`balldontlie_ncaab_get_odds_opening`

Get NCAAB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently comple...

Get NCAAF Conferences`balldontlie_ncaaf_get_conferences`

Get NCAAF conferences

Get Specific NCAAF Conference`balldontlie_ncaaf_get_conference_by_id`

Get specific NCAAF conference

Get NCAAF Teams`balldontlie_ncaaf_get_teams`

Get NCAAF teams

Get Specific NCAAF Team`balldontlie_ncaaf_get_team_by_id`

Get specific NCAAF team

Get NCAAF Players`balldontlie_ncaaf_get_players`

Get NCAAF players

Get Active NCAAF Players`balldontlie_ncaaf_get_active_players`

Get active NCAAF players

Get Specific NCAAF Player`balldontlie_ncaaf_get_player_by_id`

Get specific NCAAF player

Get NCAAF Standings`balldontlie_ncaaf_get_standings`

Get NCAAF standings

Get NCAAF Games`balldontlie_ncaaf_get_games`

Get NCAAF games

Get Specific NCAAF Game`balldontlie_ncaaf_get_game_by_id`

Get specific NCAAF game

Get NCAAF Rankings`balldontlie_ncaaf_get_rankings`

Get NCAAF rankings

Get NCAAF Play-by-play Data`balldontlie_ncaaf_get_plays`

Get NCAAF play-by-play data

Get NCAAF Player Statistics`balldontlie_ncaaf_get_player_stats`

Get NCAAF player statistics

Get NCAAF Team Statistics`balldontlie_ncaaf_get_team_stats`

Get NCAAF team statistics

Get NCAAF Player Season Statistics`balldontlie_ncaaf_get_player_season_stats`

Get NCAAF player season statistics

Get NCAAF Team Season Statistics`balldontlie_ncaaf_get_team_season_stats`

Get NCAAF team season statistics

Get NCAAF Betting Odds`balldontlie_ncaaf_get_betting_odds`

Get NCAAF betting odds Retrieve betting odds for NCAAF games. Either (season and week) or game\_ids is required.

Get NCAAF Opening Betting Odds`balldontlie_ncaaf_get_odds_opening`

Get NCAAF opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently comple...

Get Current NCAAF Player Prop Odds`balldontlie_ncaaf_get_odds_player_props`

Get current NCAAF player prop odds Retrieve current pre-game and live player prop betting odds. Sportsbook availability...

Get NCAAF Opening Player Prop Odds`balldontlie_ncaaf_get_odds_player_props_opening`

Get NCAAF opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most...

Get NCAAW Conferences`balldontlie_ncaaw_get_conferences`

Get NCAAW conferences

Get Specific NCAAW Conference`balldontlie_ncaaw_get_conference_by_id`

Get specific NCAAW conference

Get NCAAW Teams`balldontlie_ncaaw_get_teams`

Get NCAAW teams

Get Specific NCAAW Team`balldontlie_ncaaw_get_team_by_id`

Get specific NCAAW team

Get NCAAW Players`balldontlie_ncaaw_get_players`

Get NCAAW players

Get Specific NCAAW Player`balldontlie_ncaaw_get_player_by_id`

Get specific NCAAW player

Get Active NCAAW Players`balldontlie_ncaaw_get_active_players`

Get active NCAAW players

Get NCAAW Team Standings`balldontlie_ncaaw_get_standings`

Get NCAAW team standings Get team standings. Note - season values are transformed (user sends 2025, API queries DB for 2...

Get NCAAW Games`balldontlie_ncaaw_get_games`

Get NCAAW games Get games. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get Specific NCAAW Game`balldontlie_ncaaw_get_game_by_id`

Get specific NCAAW game

Get NCAAW Rankings`balldontlie_ncaaw_get_rankings`

Get NCAAW rankings Get team rankings. Note - season values are transformed (user sends 2025, API queries DB for 2026, re...

Get NCAAW Play-by-play Data`balldontlie_ncaaw_get_plays`

Get NCAAW play-by-play data

Get NCAAW Player Game Statistics`balldontlie_ncaaw_get_player_stats`

Get NCAAW player game statistics Get player statistics. Note - season values are transformed (user sends 2025, API queri...

Get NCAAW Team Game Statistics`balldontlie_ncaaw_get_team_stats`

Get NCAAW team game statistics Get team statistics. Note - season values are transformed (user sends 2025, API queries D...

Get NCAAW Player Season Statistics`balldontlie_ncaaw_get_player_season_stats`

Get NCAAW player season statistics Get player season averages. Note - season values are transformed (user sends 2025, AP...

Get NCAAW Team Season Statistics`balldontlie_ncaaw_get_team_season_stats`

Get NCAAW team season statistics Get team season averages. Note - season values are transformed (user sends 2025, API qu...

Get NCAAW Tournament Bracket Data`balldontlie_ncaaw_get_brackets`

Get NCAAW tournament bracket data Retrieve NCAA Women's Basketball tournament bracket data with optional filters (GOAT t...

Get NCAAW Betting Odds`balldontlie_ncaaw_get_betting_odds`

Get NCAAW betting odds Retrieve betting odds for NCAAW games. Either dates or game\_ids is required. Note that NCAAW odds...

Get NCAAW Opening Betting Odds`balldontlie_ncaaw_get_odds_opening`

Get NCAAW opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently comple...

Get NFL Player Designations`balldontlie_nfl_get_player_designations`

Get NFL player designations Requires GOAT access. Returns one row per player and game in the selected week. Supply seaso...

Get NFL Teams`balldontlie_nfl_get_teams`

Get NFL teams

Get Specific NFL Team`balldontlie_nfl_get_team_by_id`

Get specific NFL team

Get NFL Team Roster`balldontlie_nfl_get_team_roster`

Get NFL team roster Retrieve the current roster and depth chart for a specific NFL team. Note: Roster data is only avail...

Get NFL Players`balldontlie_nfl_get_players`

Get NFL players

Get Specific NFL Player`balldontlie_nfl_get_player_by_id`

Get specific NFL player

Get Active NFL Players`balldontlie_nfl_get_active_players`

Get active NFL players

Get NFL Games`balldontlie_nfl_get_games`

Get NFL games

Get Specific NFL Game`balldontlie_nfl_get_game_by_id`

Get specific NFL game

Get NFL Stats`balldontlie_nfl_get_stats`

Get NFL stats

Get NFL Team Standings`balldontlie_nfl_get_standings`

Get NFL team standings

Get NFL Player Injuries`balldontlie_nfl_get_player_injuries`

Get NFL player injuries

Get NFL Season Stats`balldontlie_nfl_get_season_stats`

Get NFL season stats Season totals are unavailable before the first kickoff of the requested season type, so the data ar...

Get NFL Advanced Rushing Stats`balldontlie_nfl_get_advanced_rushing_stats`

Get NFL advanced rushing stats

Get NFL Advanced Passing Stats`balldontlie_nfl_get_advanced_passing_stats`

Get NFL advanced passing stats

Get NFL Advanced Receiving Stats`balldontlie_nfl_get_advanced_receiving_stats`

Get NFL advanced receiving stats

Get NFL Betting Odds`balldontlie_nfl_get_betting_odds`

Get NFL betting odds Retrieve betting odds for NFL games, including preseason. Either (season and week) or game\_ids is r...

Get NFL Opening Betting Odds`balldontlie_nfl_get_odds_opening`

Get NFL opening betting odds Retrieve historical opening betting odds, including preseason when available. Week queries...

Get NFL Player Prop Betting Odds`balldontlie_nfl_get_player_props`

Get NFL player prop betting odds Retrieve live player prop betting data for NFL games. Player prop data is LIVE and upda...

Get NFL Opening Player Prop Odds`balldontlie_nfl_get_odds_player_props_opening`

Get NFL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get NFL Team Season Stats`balldontlie_nfl_get_team_season_stats`

Get NFL team season stats Retrieve comprehensive team season statistics including offense, defense, special teams, and o...

Get NFL Team Game Stats`balldontlie_nfl_get_team_stats`

Get NFL team game stats Retrieve team statistics for individual games

Get NFL Fantasy Scoring Formats`balldontlie_nfl_get_fantasy_scoring_formats`

Get NFL fantasy scoring formats Returns season-specific scoring definitions referenced by available fantasy data. The fl...

Get NFL Fantasy Projections`balldontlie_nfl_get_fantasy_projections`

Get NFL fantasy projections Returns season projections when `week` is omitted and weekly lineup projections with game co...

Get NFL Weekly Fantasy Stats`balldontlie_nfl_get_fantasy_weekly_stats`

Get NFL weekly fantasy stats Returns observed weekly player or team-defense statistics, game context, and fantasy-point...

Get NFL Fantasy Rankings`balldontlie_nfl_get_fantasy_rankings`

Get NFL fantasy rankings Returns fantasy ranking variants, position ranks, and auction values. The `ranking_type` parame...

Get NFL Fantasy ADP And Ownership Data`balldontlie_nfl_get_fantasy_adp`

Get NFL fantasy ADP and ownership data Returns average draft position, auction value, rostered and started percentages,...

Get NFL DFS Slates`balldontlie_nfl_get_dfs_slates`

Get NFL DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event w\...

Get A NFL DFS Slate`balldontlie_nfl_get_dfs_slates_by_id`

Get a NFL DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game\_id values u...

Get NFL DFS Draftables`balldontlie_nfl_get_dfs_draftables`

Get NFL DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary...

Get NFL Play-by-play Data`balldontlie_nfl_get_plays`

Get NFL play-by-play data Retrieve play-by-play data for NFL games, ordered chronologically by wallclock time

Get NHL Teams`balldontlie_nhl_get_teams`

Get NHL teams

Get Specific NHL Team`balldontlie_nhl_get_team_by_id`

Get specific NHL team

Get NHL Team Season Statistics`balldontlie_nhl_get_team_season_stats`

Get NHL team season statistics

Get NHL Players`balldontlie_nhl_get_players`

Get NHL players

Get NHL Player Season Statistics`balldontlie_nhl_get_player_season_stats`

Get NHL player season statistics

Get NHL Games`balldontlie_nhl_get_games`

Get NHL games

Get NHL Standings`balldontlie_nhl_get_standings`

Get NHL standings

Get NHL Box Scores`balldontlie_nhl_get_box_scores`

Get NHL box scores

Get NHL Play-by-play Data`balldontlie_nhl_get_plays`

Get NHL play-by-play data Returns play-by-play data for a specific game. Plays are returned in chronological order with...

Get All Currently Injured NHL Players`balldontlie_nhl_get_player_injuries`

Get all currently injured NHL players Returns all players currently on the injury report. The data is updated regularly...

Get NHL Player Statistical Leaders`balldontlie_nhl_get_player_stats_leaders`

Get NHL player statistical leaders

Get NHL Team Statistical Leaders`balldontlie_nhl_get_team_stats_leaders`

Get NHL team statistical leaders

Get NHL Betting Odds`balldontlie_nhl_get_betting_odds`

Get NHL betting odds Retrieve betting odds for NHL games. Either dates or game\_ids is required.

Get NHL Opening Betting Odds`balldontlie_nhl_get_odds_opening`

Get NHL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get NHL Player Prop Betting Odds`balldontlie_nhl_get_player_props`

Get NHL player prop betting odds Retrieve live player prop betting data for NHL games. Player prop data is LIVE and upda...

Get NHL Opening Player Prop Odds`balldontlie_nhl_get_odds_player_props_opening`

Get NHL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get PGA Tour Players`balldontlie_pga_get_players`

Get PGA Tour players Retrieve PGA Tour players with optional filters. Free tier.

Get PGA Tour Tournaments (v1)`balldontlie_pga_get_v1_tournaments`

Get PGA Tour tournaments (v1) Deprecated for new integrations. Use `/pga/v2/tournaments`, which provides normalized date...

Get PGA Tour Tournaments`balldontlie_pga_get_tournaments`

Get PGA Tour tournaments Retrieve tournaments with normalized date fields. Set include\_format=true to add format\_type wi...

Get Tournament Competitors`balldontlie_pga_get_v2_tournament_competitors`

Get tournament competitors Retrieve players, teams, cup teams, and pairings for one tournament. Requires GOAT tier.

Get Format-aware Tournament Results`balldontlie_pga_get_v2_tournament_results`

Get format-aware tournament results Retrieve the primary result population for one tournament. PLAYER rows are returned...

Get Tournament Rounds`balldontlie_pga_get_v2_rounds`

Get tournament rounds Retrieve every known round and its round-specific format for one tournament. Free tier. This endpo...

Get Format-aware Tee Groups`balldontlie_pga_get_v2_tee_times`

Get format-aware tee groups Retrieve tee groups with complete participant arrays. Pairings and match relationships are p...

Get Tournament Matches`balldontlie_pga_get_v2_matches`

Get tournament matches Retrieve match-play or team-cup matches with complete side arrays. Returns an empty data array wh...

Get Match Hole Scores`balldontlie_pga_get_v2_match_holes`

Get match hole scores Retrieve hole-by-hole side and player scoring for one match. Requires GOAT tier. This endpoint is...

Get PGA Tour Courses`balldontlie_pga_get_courses`

Get PGA Tour courses Retrieve golf courses with optional filters. Free tier.

Get PGA Tournament Results`balldontlie_pga_get_tournament_results`

Get PGA tournament results Deprecated for new integrations. Use `/pga/v2/tournament_results` for format-aware player, te...

Get PGA Tournament Field`balldontlie_pga_get_tournament_field`

Get PGA tournament field Deprecated for new integrations. Use `/pga/v2/tournament_competitors` for players, teams, pairi...

Get PGA Tee Times`balldontlie_pga_get_tee_times`

Get PGA tee times Deprecated for new integrations. Use `/pga/v2/tee_times` for format-aware tee groups and complete part...

Get Tournament Course Statistics`balldontlie_pga_get_tournament_course_stats`

Get tournament course statistics Retrieve hole-by-hole tournament statistics. Requires ALL-STAR tier.

Get Course Holes`balldontlie_pga_get_course_holes`

Get course holes Retrieve hole-by-hole course information. Requires ALL-STAR tier.

Get Player Round Results`balldontlie_pga_get_player_round_results`

Get player round results Retrieve round-by-round player scores. Requires GOAT tier.

Get Player Round Statistics`balldontlie_pga_get_player_round_stats`

Get player round statistics Retrieve detailed player round statistics including strokes gained. Use round\_number=-1 for...

Get Player Season Statistics`balldontlie_pga_get_player_season_stats`

Get player season statistics Retrieve player season-level statistics. Requires GOAT tier.

Get Player Scorecards`balldontlie_pga_get_player_scorecards`

Get player scorecards Retrieve hole-by-hole player scores. Requires GOAT tier.

Get PGA Futures Odds`balldontlie_pga_get_futures`

Get PGA futures odds Retrieve futures betting odds for PGA tournaments (e.g., tournament winner). Requires GOAT tier.

Get PGA Player Props`balldontlie_pga_get_player_props`

Get PGA player props Retrieve player prop betting odds for a PGA tournament (e.g., round scores, hole scores, birdies)....

Get PGA Tour Opening Player Prop Odds`balldontlie_pga_get_odds_player_props_opening`

Get PGA Tour opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the m...

Get Serie A Teams`balldontlie_seriea_get_teams`

Get Serie A teams Get all teams participating in Serie A for a given season

Get Serie A Team Rosters`balldontlie_seriea_get_rosters`

Get Serie A team rosters Get player roster information for a specific team and season

Get Serie A Players`balldontlie_seriea_get_players`

Get Serie A players Get players with optional filtering by team or search term. Supports pagination.

Get Serie A Player Injuries`balldontlie_seriea_get_player_injuries`

Get Serie A player injuries Retrieve the current Serie A player injury snapshot. Supports filtering by player IDs, team...

Get Serie A Standings`balldontlie_seriea_get_standings`

Get Serie A standings Get league standings for a specific season

Get Serie A Matches`balldontlie_seriea_get_matches`

Get Serie A matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get Serie A Match Events`balldontlie_seriea_get_match_events`

Get Serie A match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Suppor...

Get Serie A Match Lineups`balldontlie_seriea_get_match_lineups`

Get Serie A match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Suppor...

Get Serie A Player Match Statistics`balldontlie_seriea_get_player_match_stats`

Get Serie A player match statistics Get player match statistics with optional filtering by matches or players. Supports...

Get Serie A Team Match Statistics`balldontlie_seriea_get_team_match_stats`

Get Serie A team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagina...

Get Serie A Betting Odds`balldontlie_seriea_get_betting_odds`

Get Serie A betting odds Retrieve betting odds for Serie A matches. Supports filtering by match IDs or dates. Serie A od...

Get Serie A Opening Betting Odds`balldontlie_seriea_get_odds_opening`

Get Serie A opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently comp...

Get Serie A Player Prop Betting Odds`balldontlie_seriea_get_player_props`

Get Serie A player prop betting odds Retrieve live player prop betting data for Serie A matches. Player prop data is LIV...

Get Serie A Opening Player Prop Odds`balldontlie_seriea_get_odds_player_props_opening`

Get Serie A opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the mo...

Get Serie A Match Shots`balldontlie_seriea_get_match_shots`

Get Serie A match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for m...

Get Serie A Match Attack Momentum`balldontlie_seriea_get_match_momentum`

Get Serie A match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negat...

Get Serie A Match Top Performers`balldontlie_seriea_get_match_best_players`

Get Serie A match top performers Retrieve the top-rated players for each match (best XI per side and the man of the matc...

Get Serie A Player Average Positions`balldontlie_seriea_get_match_avg_positions`

Get Serie A player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coord...

Get Serie A Player Heatmaps`balldontlie_seriea_get_match_heatmaps`

Get Serie A player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match c...

Get Serie A Pre-match Team Form`balldontlie_seriea_get_match_pregame_forms`

Get Serie A pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league pos...

Get UCL Teams`balldontlie_ucl_get_teams`

Get UCL teams Get all teams participating in the Champions League for a given season

Get UCL Team Rosters`balldontlie_ucl_get_rosters`

Get UCL team rosters Get player roster information for a specific team and season

Get UCL Players`balldontlie_ucl_get_players`

Get UCL players Get players with optional filtering by team or search term. Supports pagination.

Get UCL Player Injuries`balldontlie_ucl_get_player_injuries`

Get UCL player injuries Retrieve the current UCL player injury snapshot. Supports filtering by player IDs, team IDs, or...

Get UCL Standings`balldontlie_ucl_get_standings`

Get UCL standings Get league standings for a specific season

Get UCL Matches`balldontlie_ucl_get_matches`

Get UCL matches Get matches with optional filtering by season, dates, or teams. Supports pagination.

Get UCL Match Events`balldontlie_ucl_get_match_events`

Get UCL match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports p...

Get UCL Match Lineups`balldontlie_ucl_get_match_lineups`

Get UCL match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports p...

Get UCL Player Match Statistics`balldontlie_ucl_get_player_match_stats`

Get UCL player match statistics Get player match statistics with optional filtering by matches or players. Supports pagi...

Get UCL Team Match Statistics`balldontlie_ucl_get_team_match_stats`

Get UCL team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination...

Get UCL Betting Odds`balldontlie_ucl_get_betting_odds`

Get UCL betting odds Retrieve betting odds for UCL matches. Supports filtering by match IDs or dates. UCL odds include m...

Get UCL Opening Betting Odds`balldontlie_ucl_get_odds_opening`

Get UCL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get UCL Player Prop Betting Odds`balldontlie_ucl_get_player_props`

Get UCL player prop betting odds Retrieve live player prop betting data for UCL matches. Player prop data is LIVE and up...

Get UCL Opening Player Prop Odds`balldontlie_ucl_get_odds_player_props_opening`

Get UCL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most r...

Get UCL Futures Odds`balldontlie_ucl_get_futures_odds`

Get UCL futures odds Retrieve futures betting odds for UEFA Champions League (e.g., tournament winner). Only available f...

Get UCL Match Shots`balldontlie_ucl_get_match_shots`

Get UCL match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for match...

Get UCL Match Attack Momentum`balldontlie_ucl_get_match_momentum`

Get UCL match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative...

Get UCL Match Top Performers`balldontlie_ucl_get_match_best_players`

Get UCL match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match)....

Get UCL Player Average Positions`balldontlie_ucl_get_match_avg_positions`

Get UCL player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinat...

Get UCL Player Heatmaps`balldontlie_ucl_get_match_heatmaps`

Get UCL player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concl...

Get UCL Pre-match Team Form`balldontlie_ucl_get_match_pregame_forms`

Get UCL pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league positio...

List Valorant Regions`balldontlie_valorant_get_regions`

List Valorant regions Returns the available competitive regions. Requires Free tier or higher.

List Countries`balldontlie_valorant_get_countries`

List countries Returns countries and their competitive regions. Requires Free tier or higher.

List Tournament Series`balldontlie_valorant_get_series`

List tournament series Returns tournament series. Requires Free tier or higher.

List Maps`balldontlie_valorant_get_maps`

List maps Returns Valorant maps and map-pool metadata. Requires Free tier or higher.

List Agents`balldontlie_valorant_get_agents`

List agents Returns Valorant agents. Requires Free tier or higher.

List Weapons`balldontlie_valorant_get_weapons`

List weapons Returns Valorant weapons. Requires Free tier or higher.

List Teams`balldontlie_valorant_get_teams`

List teams Returns Valorant teams. Requires Free tier or higher.

List Players`balldontlie_valorant_get_players`

List players Returns Valorant players. Requires Free tier or higher.

List Player Profiles`balldontlie_valorant_get_player_profiles`

List player profiles Returns competitive profiles linked to players when known. Requires Free tier or higher.

List Player Crosshairs`balldontlie_valorant_get_player_crosshairs`

List player crosshairs Returns published player crosshair codes. Requires Free tier or higher.

List Aggregate Agent Statistics`balldontlie_valorant_get_agent_stats`

List aggregate agent statistics Returns aggregate performance statistics by agent. Requires ALL-STAR tier or higher.

List Player Transfers`balldontlie_valorant_get_player_transfers`

List player transfers Returns player and coach transfer history. Requires ALL-STAR tier or higher.

List Tournaments`balldontlie_valorant_get_tournaments`

List tournaments Returns Valorant tournaments. Requires ALL-STAR tier or higher.

List Tournament Stages`balldontlie_valorant_get_tournament_stages`

List tournament stages Returns the stages for one tournament. Requires ALL-STAR tier or higher.

List Tournament Teams`balldontlie_valorant_get_tournament_teams`

List tournament teams Returns the teams participating in one tournament. Requires ALL-STAR tier or higher.

List Tournament Prizes`balldontlie_valorant_get_tournament_prizes`

List tournament prizes Returns placements and prizes for one tournament. Requires ALL-STAR tier or higher.

List A Tournament Roster`balldontlie_valorant_get_tournament_roster`

List a tournament roster Returns players and coaches registered for one tournament. Requires ALL-STAR tier or higher.

List Matches`balldontlie_valorant_get_matches`

List matches Returns scheduled, current, and completed Valorant matches. Requires GOAT tier or higher.

List Maps For A Match`balldontlie_valorant_get_match_maps`

List maps for a match Returns the individual maps played in one match. Requires GOAT tier or higher.

List Live Match Snapshots`balldontlie_valorant_get_live_matches`

List live match snapshots Returns the latest available live snapshot for current matches, including player state. The co...

List Aggregate Player Statistics`balldontlie_valorant_get_player_overall_stats`

List aggregate player statistics Returns career aggregate statistics for competitive player profiles. Requires GOAT tier...

List Player Statistics For A Match`balldontlie_valorant_get_player_match_stats`

List player statistics for a match Returns finalized aggregate player statistics for one completed match. Requires GOAT...

List Player Statistics For A Match Map`balldontlie_valorant_get_player_match_map_stats`

List player statistics for a match map Returns player statistics for one match map. Live snapshots have is\_final=false a...

List Rounds For A Match Map`balldontlie_valorant_get_rounds`

List rounds for a match map Returns rounds for one match map. Live snapshots have is\_final=false and snapshot\_at populat...

List Player Statistics For A Round`balldontlie_valorant_get_player_round_stats`

List player statistics for a round Returns finalized player statistics for one round. Requires GOAT tier or higher. This...

List Team Statistics For A Round`balldontlie_valorant_get_team_round_stats`

List team statistics for a round Returns finalized team statistics for one round. Requires GOAT tier or higher. This end...

List Player Weapon Statistics For A Match`balldontlie_valorant_get_player_match_weapon_stats`

List player weapon statistics for a match Returns finalized player kill totals by weapon for one match. Requires GOAT ti...

Get WNBA Teams`balldontlie_wnba_get_teams`

Get WNBA teams

Get Specific WNBA Team`balldontlie_wnba_get_team_by_id`

Get specific WNBA team

Get WNBA Players`balldontlie_wnba_get_players`

Get WNBA players

Get Active WNBA Players`balldontlie_wnba_get_active_players`

Get active WNBA players

Get Specific WNBA Player`balldontlie_wnba_get_player_by_id`

Get specific WNBA player

Get WNBA Games`balldontlie_wnba_get_games`

Get WNBA games

Get Specific WNBA Game`balldontlie_wnba_get_game_by_id`

Get specific WNBA game

Get WNBA Player Statistics`balldontlie_wnba_get_player_stats`

Get WNBA player statistics

Get WNBA Team Statistics`balldontlie_wnba_get_team_stats`

Get WNBA team statistics

Get WNBA Player Season Statistics`balldontlie_wnba_get_player_season_stats`

Get WNBA player season statistics

Get WNBA Team Season Statistics`balldontlie_wnba_get_team_season_stats`

Get WNBA team season statistics

Get WNBA Player Game Advanced Statistics`balldontlie_wnba_get_player_game_advanced_stats`

Get WNBA player game advanced statistics

Get WNBA Team Game Advanced Statistics`balldontlie_wnba_get_team_game_advanced_stats`

Get WNBA team game advanced statistics

Get WNBA Player Season Advanced Statistics`balldontlie_wnba_get_player_season_advanced_stats`

Get WNBA player season advanced statistics

Get WNBA Team Season Advanced Statistics`balldontlie_wnba_get_team_season_advanced_stats`

Get WNBA team season advanced statistics

Get WNBA Player Shot Location Statistics`balldontlie_wnba_get_player_shot_locations`

Get WNBA player shot location statistics

Get WNBA Team Shot Location Statistics`balldontlie_wnba_get_team_shot_locations`

Get WNBA team shot location statistics

Get WNBA Standings`balldontlie_wnba_get_standings`

Get WNBA standings

Get WNBA Player Injuries`balldontlie_wnba_get_player_injuries`

Get WNBA player injuries

Get WNBA Betting Odds`balldontlie_wnba_get_odds`

Get WNBA betting odds Retrieve betting odds for WNBA games. Either dates or game\_ids is required.

Get WNBA Opening Betting Odds`balldontlie_wnba_get_odds_opening`

Get WNBA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complet...

Get WNBA Player Prop Betting Odds`balldontlie_wnba_get_odds_player_props`

Get WNBA player prop betting odds Retrieve live player prop betting data for WNBA games. Player prop data is LIVE and up...

Get WNBA Opening Player Prop Odds`balldontlie_wnba_get_odds_player_props_opening`

Get WNBA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most...

Get WNBA Play-by-play Data`balldontlie_wnba_get_plays`

Get WNBA play-by-play data

Get WTA Players`balldontlie_wta_get_players`

Get WTA players Retrieve WTA tennis players with optional filters. Women's singles only. Free tier.

Get Specific WTA Player`balldontlie_wta_get_player`

Get specific WTA player Retrieve a single WTA player by ID. Free tier.

Get WTA Tournaments`balldontlie_wta_get_tournaments`

Get WTA tournaments Retrieve WTA tournaments with optional filters. Free tier.

Get Specific WTA Tournament`balldontlie_wta_get_tournament`

Get specific WTA tournament Retrieve a single WTA tournament by ID. Free tier.

Get WTA Rankings`balldontlie_wta_get_rankings`

Get WTA rankings Retrieve current WTA rankings. Free tier.

Get WTA Matches`balldontlie_wta_get_matches`

Get WTA matches Retrieve WTA matches with optional filters. Requires ALL-STAR tier.

Get Specific WTA Match`balldontlie_wta_get_match`

Get specific WTA match Retrieve a single WTA match by ID. Requires ALL-STAR tier.

Get WTA Player Career Statistics`balldontlie_wta_get_player_career_stats`

Get WTA player career statistics Retrieve career statistics for WTA players. Requires GOAT tier.

Get WTA Head-to-head Record`balldontlie_wta_get_head_to_head`

Get WTA head-to-head record Retrieve head-to-head record between two players. Requires GOAT tier.

Get WTA Betting Odds`balldontlie_wta_get_odds`

Get WTA betting odds Retrieve betting odds for WTA matches. Requires at least one filter. Requires GOAT tier.

Get WTA Opening Betting Odds`balldontlie_wta_get_odds_opening`

Get WTA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently complete...

Get WTA Match Statistics`balldontlie_wta_get_match_stats`

Get WTA match statistics Retrieve detailed match statistics. Requires GOAT tier.

Get Team Contracts`balldontlie_get_team_contracts`

Retrieve every player contract on a single NBA team for a season.

Get Player Contracts`balldontlie_get_player_contracts`

Retrieve a single player's contracts, optionally narrowed to specific seasons.

Get Player Contract Aggregates`balldontlie_get_player_contract_aggregates`

Retrieve multi-year contract totals for a single player, including total value and guaranteed money.

List DFS Slates`balldontlie_list_dfs_slates`

Retrieve provider-neutral daily fantasy sports slates, with their format, event window, salary cap and single or multi-g...

Get DFS Slate Details`balldontlie_get_dfs_slate_details`

Retrieve a single DFS slate with its included real-game events and lineup roster slots.

List DFS Draftables`balldontlie_list_dfs_draftables`

Retrieve the players or teams selectable for a DFS slate roster slot, with position, salary and availability.

Get All Games`balldontlie_get_all_games`

Retrieve NBA games filtered by date, date range, season, season type or team.

Get A Specific Game`balldontlie_get_a_specific_game`

Retrieve a single NBA game by its BALLDONTLIE game ID.

Get Box Scores`balldontlie_get_box_scores`

Retrieve complete box scores for every NBA game played on a specific date.

Get Live Box Scores`balldontlie_get_live_box_scores`

Retrieve live box scores for NBA games currently in progress.

Get Game Lineups`balldontlie_get_game_lineups`

Retrieve starting lineups and bench players for one or more NBA games.

Get Play-by-Play Data`balldontlie_get_play_by_play_data`

Retrieve the full chronological play-by-play feed for a single NBA game.

Get Betting Odds`balldontlie_get_betting_odds`

Retrieve current game-level betting odds — moneyline, spread and over/under — for NBA games by date or game ID.

Get Opening Betting Odds`balldontlie_get_opening_betting_odds`

Retrieve the historical opening game-level betting odds for NBA games by date or game ID.

Get Player Props`balldontlie_get_player_props`

Retrieve live player prop betting lines for a single NBA game, optionally narrowed by player, prop type or sportsbook.

Get Opening Player Props`balldontlie_get_opening_player_props`

Retrieve the historical opening player prop betting lines for a single NBA game.

Get All Players`balldontlie_get_all_players`

Retrieve NBA players with optional name search and team or player ID filters. Includes historical players.

Get A Specific Player`balldontlie_get_a_specific_player`

Retrieve a single NBA player by their BALLDONTLIE player ID.

Get All Active Players`balldontlie_get_all_active_players`

Retrieve only players currently on an NBA roster, with the same search and filter options as Get All Players.

Get All Player Injuries`balldontlie_get_all_player_injuries`

Retrieve current NBA injury reports, optionally filtered by team or player.

Season Averages`balldontlie_season_averages`

Retrieve a single player's per-game season averages for one season.

Get Averages`balldontlie_get_averages`

Retrieve player season averages for a statistical category — general, clutch, defense or shooting — with a specific spli...

Get All Stats`balldontlie_get_all_stats`

Retrieve per-game player statistics filtered by player, game, date, date range or season.

Get All Advanced Stats (V2)`balldontlie_get_all_advanced_stats_v2`

Retrieve advanced per-game player statistics including efficiency ratings, tracking data, hustle stats, defensive matchu...

Get Leaders`balldontlie_get_leaders`

Retrieve the NBA league leaders for a single statistic in a given season.

Get All Teams`balldontlie_get_all_teams`

Retrieve all NBA teams, optionally narrowed to a single division or conference.

Get A Specific Team`balldontlie_get_a_specific_team`

Retrieve a single NBA team by its BALLDONTLIE team ID.

Get Team Standings`balldontlie_get_team_standings`

Retrieve NBA team standings for a season, including conference and division records.

Get Team Season Averages`balldontlie_get_team_season_averages`

Retrieve team-level season averages for a statistical category, such as general, clutch, shooting, playtype, tracking, h...

## Events

Tags

Select all
|
Clear

Health Checks

Webhooks

No tags found

15 events

EventDescriptionTags

Game Started`balldontlie_webhook_game_started`

Processes events fired when an NBA game begins.

Webhooks

Game Ended`balldontlie_webhook_game_ended`

Processes events fired when an NBA game reaches final.

Webhooks

Game Period Ended`balldontlie_webhook_game_period_ended`

Processes events fired when a period or quarter ends.

Webhooks

Game Overtime`balldontlie_webhook_game_overtime`

Processes events fired when a game enters overtime.

Webhooks

Player Scored`balldontlie_webhook_player_scored`

Processes events fired when a player scores.

Webhooks

Player Rebound`balldontlie_webhook_player_rebound`

Processes events fired when a player gets a rebound.

Webhooks

Player Assist`balldontlie_webhook_player_assist`

Processes events fired when a player records an assist.

Webhooks

Player Steal`balldontlie_webhook_player_steal`

Processes events fired when a player records a steal.

Webhooks

Player Block`balldontlie_webhook_player_block`

Processes events fired when a player records a block.

Webhooks

Player Foul`balldontlie_webhook_player_foul`

Processes events fired when a player commits a foul.

Webhooks

Player Turnover`balldontlie_webhook_player_turnover`

Processes events fired when a player commits a turnover.

Webhooks

Injury Created`balldontlie_webhook_injury_created`

Processes events fired when a player is added to the injury report.

Webhooks

Injury Updated`balldontlie_webhook_injury_updated`

Processes events fired when a player's injury details change.

Webhooks

Injury Cleared`balldontlie_webhook_injury_cleared`

Processes events fired when a player is removed from the injury report.

Webhooks

Active Check`balldontlie_webhook_active_check`

Returns 200 OK for webhook deliveries that do not carry a recognised NBA event type.

Health Checks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.