BALLDONTLIE

Live 559 Actions 15 Events

BALLDONTLIE Integration for AI Agents

Connect your AI agent to 559 QA'd BALLDONTLIE actions via MCP, A2A, or SDK, with agent authentication, tool-calling execution, and security built-in, plus 15 events to subscribe to.

Start Free Book Demo BALLDONTLIE MCP Server

BALLDONTLIE AI Agent Actions

559 production-ready actions for your agent to do more on BALLDONTLIE.

Read the BALLDONTLIE docs

559 Actions

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

Create A New Account - Create a new account Creates a new user account and returns the API key immediately. No authentication required. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Get Current User Profile - Get current user profile Returns the authenticated user's profile including email, API key, tier, and subscriptions. Security: the MCP response omits the api_key field.

Rotate API Key - Rotate API key Generates a new API key and invalidates the old one immediately. The response includes the new key. All subsequent requests must use the new key. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

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

Create Or Change Subscription - Create or change subscription Subscribe to a sport, upgrade, or downgrade your plan. If no payment method is on file, returns `402` with a `payment_url` for hosted billing checkout (human must visit to enter card details). If a payment method exists, the subscription change is processed immediately and the response indicates `processing`. Poll `GET /account/v1/subscriptions` to check when the change is reflected. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Cancel Subscription - Cancel subscription Cancel a subscription for a specific sport. Active subscriptions are scheduled for cancellation at the end of the billing period (access continues until then). Incomplete/unpaid subscriptions are canceled immediately. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

List All Available Plans - List all available plans Returns all available subscription plans with pricing, rate limits, and links to per-sport OpenAPI specs. Includes paid-only StoryStats plans such as stories_wnba and stories_nfl. BALLDONTLIE all-access includes every sport, Lab, Webhooks, and StoryStats. No authentication required.

Get Plan For A Specific Sport - Get plan for a specific sport Returns plan details for a single sport. No authentication required.

Generate Checkout URL - Generate checkout URL Creates a hosted billing checkout session for a specific plan and returns the URL. A human must visit this URL to enter payment details. Use this when you want to proactively generate a payment link (e.g., for an onboarding flow). Unlike POST /subscriptions, this endpoint always generates a checkout URL regardless of whether a payment method exists. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

Get Billing Portal URL - Get billing portal URL Generates a hosted billing portal URL where a human can update payment methods, view invoices, and manage billing details. Security: this tool is disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS is exactly true. Its result may contain credentials or a sensitive billing-session URL.

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

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

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

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

Get ATP Rankings - Get ATP rankings Retrieve current ATP rankings. Free tier.

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

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

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

Get ATP Match Statistics - Get ATP match statistics Retrieve detailed match statistics. Requires GOAT tier.

Get ATP Player Career Statistics - Get ATP player career statistics Retrieve career statistics for players. Requires GOAT tier.

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

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

Get ATP Opening Betting Odds - Get ATP opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

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

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

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

Get Bundesliga Player Injuries - Get Bundesliga player injuries Retrieve the current Bundesliga player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get Bundesliga Standings - Get Bundesliga standings Get league standings for a specific season

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

Get Bundesliga Match Events - Get Bundesliga match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get Bundesliga Match Lineups - Get Bundesliga match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get Bundesliga Player Match Statistics - Get Bundesliga player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get Bundesliga Team Match Statistics - Get Bundesliga team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get Bundesliga Betting Odds - Get Bundesliga betting odds Retrieve betting odds for Bundesliga matches. Supports filtering by match IDs or dates. Bundesliga odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get Bundesliga Opening Betting Odds - Get Bundesliga opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Bundesliga Player Prop Betting Odds - Get Bundesliga player prop betting odds Retrieve live player prop betting data for Bundesliga matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get Bundesliga Opening Player Prop Odds - Get Bundesliga opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Bundesliga Match Shots - Get Bundesliga match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get Bundesliga Match Attack Momentum - Get Bundesliga match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Bundesliga Match Top Performers - Get Bundesliga match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get Bundesliga Player Average Positions - Get Bundesliga player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Bundesliga Player Heatmaps - Get Bundesliga player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get Bundesliga Pre-match Team Form - Get Bundesliga pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get CBB Conferences - Get CBB conferences

Get CBB Teams - Get CBB teams

Get CBB Players - Get CBB players

Get CBB Team Standings - Get CBB team standings

Get CBB Games - Get CBB games

Get CBB Rankings - Get CBB rankings

Get Active CBB Players - Get active CBB players

Get CBB Play-by-play Data - Get CBB play-by-play data

Get CBB Player Batting Statistics - Get CBB player batting statistics

Get CBB Player Pitching Statistics - Get CBB player pitching statistics

Get CBB Team Batting Statistics - Get CBB team batting statistics

Get CBB Team Pitching Statistics - Get CBB team pitching statistics

Get CBB Team Fielding Statistics - Get CBB team fielding statistics

Get CBB Player Season Batting Statistics - Get CBB player season batting statistics

Get CBB Player Season Pitching Statistics - Get CBB player season pitching statistics

Get CBB Team Season Statistics - Get CBB team season statistics

Get CBB Betting Odds - Get CBB betting odds Retrieve betting odds for CBB games. Either dates or game_ids is required.

Get CBB Opening Betting Odds - Get CBB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

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

Get Specific CS2 Team - Get specific CS2 team Retrieve details for a specific CS2 team

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

Get Specific CS2 Player - Get specific CS2 player Retrieve details for a specific CS2 player

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

Get Specific CS2 Tournament - Get specific CS2 tournament Retrieve details for a specific CS2 tournament

Get Tournament Teams - Get tournament teams Retrieve all teams participating in a specific CS2 tournament

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

Get CS2 Team Rankings - Get CS2 team rankings Retrieve current official CS2 team rankings based on the Valve World Rankings system. Requires ALL-STAR tier or higher.

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

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

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

Get Match Map Statistics - Get match map statistics Retrieve detailed round-by-round statistics for a specific map in a CS2 match. Requires GOAT tier.

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

Get Player Match Map Statistics - Get player match map statistics Retrieve player statistics for a specific map within a CS2 match. Requires GOAT tier.

Get Player Accuracy Statistics - Get player accuracy statistics Retrieve accuracy statistics for a specific CS2 player, broken down by hit groups (body parts). Requires GOAT tier.

Get All Dota 2 Teams - Get all Dota 2 teams Retrieve a list of all professional Dota 2 teams

Get All Dota 2 Players - Get all Dota 2 players Retrieve a list of all professional Dota 2 players

Get All Dota 2 Heroes - Get all Dota 2 heroes Retrieve a list of all Dota 2 heroes

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

Get All Dota 2 Abilities - Get all Dota 2 abilities Retrieve a list of all Dota 2 hero abilities

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

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

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 - Get hero statistics Retrieve aggregate statistics for Dota 2 heroes across professional matches. Requires ALL-STAR tier or higher.

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

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

Get Player Match Map Statistics - Get player match map statistics Retrieve detailed player statistics for individual Dota 2 games. Requires GOAT tier.

Get Team Match Map Statistics - Get team match map statistics Retrieve detailed team statistics for individual Dota 2 games. Requires GOAT tier.

Get Player Overall Statistics - Get player overall statistics Retrieve career statistics for Dota 2 players. Requires GOAT tier.

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

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

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

Get EPL Player Injuries - Get EPL player injuries Retrieve the current EPL player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get EPL Standings - Get EPL standings Get league standings for a specific season

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

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

Get EPL Match Lineups - Get EPL match lineups Get player lineups for matches. Supports pagination.

Get EPL Player Match Statistics - Get EPL player match statistics Get individual player statistics for matches. Supports pagination.

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

Get EPL 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 - Get EPL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get EPL Player Prop Betting Odds - Get EPL player prop betting odds Retrieve live player prop betting data for EPL matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get EPL Opening Player Prop Odds - Get EPL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get EPL Match Shots - Get EPL match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get EPL Match Attack Momentum - Get EPL match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get EPL Match Top Performers - Get EPL match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get EPL Player Average Positions - Get EPL player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get EPL Player Heatmaps - Get EPL player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get EPL Pre-match Team Form - Get EPL pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

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

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

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

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

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

Get F1 Sessions - Get F1 sessions Retrieve a list of Formula 1 sessions (Practice, Qualifying, Sprint, Race) with optional filtering. Requires PAID tier or higher.

Get F1 Session Results - Get F1 session results Retrieve Formula 1 session results (finishing positions, laps completed, etc.) with optional filtering. Requires PAID tier or higher.

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

Get F1 Team Standings - Get F1 team standings Retrieve Formula 1 Constructors Championship standings for a specific season. Requires PAID tier or higher.

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

Get F1 Qualifying Results - Get F1 qualifying results Retrieve detailed qualifying session results including Q1, Q2, and Q3 times. Requires PAID+ tier.

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

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

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

Get F1 Race Control Messages - Get F1 race control messages Retrieve race control messages including flags, safety car, and DRS notifications. Requires PAID+ tier.

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

Get F1 Session Timing Stats - Get F1 session timing stats Retrieve detailed timing statistics including best laps, sector times, and speed trap data. Requires PAID+ tier.

Get F1 Track Status - Get F1 track status Retrieve track status changes during sessions (green flag, yellow flag, safety car, etc.). Requires PAID+ tier.

Get F1 Futures Odds - Get F1 futures odds Retrieve futures betting odds for Formula 1 championships (e.g., driver championship winner, constructor championship winner). Requires PAID+ tier.

Get FIFA World Cup Teams - Get FIFA World Cup teams Retrieve participating nations for the requested World Cup edition(s). Defaults to 2026 when seasons[] is omitted.

Get FIFA World Cup Stadiums - Get FIFA World Cup stadiums Retrieve host stadiums used by the requested World Cup edition(s). Defaults to 2026 when seasons[] is omitted.

Get FIFA World Cup Group Standings - Get FIFA World Cup group standings Retrieve group stage standings for the requested World Cup edition(s). Defaults to 2026 when seasons[] is omitted. Requires ALL-STAR tier or higher.

Get FIFA World Cup 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 - Get FIFA World Cup betting odds Retrieve moneyline, spread, total, and additional match betting markets for World Cup matches. Cursor-paginated. Requires GOAT tier.

Get FIFA Opening Betting Odds - Get FIFA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get FIFA World Cup Futures Odds - Get FIFA World Cup futures odds Retrieve futures betting odds for the FIFA World Cup. Defaults to 2026 when seasons[] is omitted. Requires GOAT tier.

Get FIFA World Cup Player Prop Betting Odds - Get FIFA World Cup player prop betting odds Retrieve live player prop betting data for FIFA World Cup matches. Player prop data is live and updated in real time. This endpoint returns all player props for the specified match in a single response. Cursor pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: betmgm, betrivers, caesars, draftkings, fanatics, fanduel

Get FIFA Opening Player Prop Odds - Get FIFA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get FIFA World Cup Players - Get FIFA World Cup players Retrieve biographical data for players who have appeared in any World Cup squad. When `seasons[]`, `team_ids[]`, and `player_ids[]` are omitted, returns all players across every ingested edition. Requires GOAT tier.

Get FIFA World Cup Player Injuries - Get FIFA World Cup player injuries Retrieve the current FIFA World Cup player injury snapshot. Supports filtering by World Cup edition, player IDs, team IDs, or injury status. Defaults to the current edition when `seasons[]` is omitted. Requires GOAT tier.

Get FIFA World Cup Tournament Rosters - Get FIFA World Cup tournament rosters Retrieve per-tournament squad entries with cumulative tournament stats. When `seasons[]` is omitted, returns rosters across every ingested edition. Requires GOAT tier.

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

Get FIFA World Cup Match Events - Get FIFA World Cup match events Retrieve time-ordered match incidents (goals, cards, substitutions, period markers, shootout kicks). Requires GOAT tier.

Get FIFA World Cup 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 - Get FIFA World Cup team match stats Retrieve per-team per-match aggregates. Requires GOAT tier.

Get FIFA World Cup 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 - Get FIFA World Cup match attack momentum Retrieve per-minute attack momentum values. Requires GOAT tier.

Get FIFA World Cup Match Top Performers - Get FIFA World Cup match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Requires GOAT tier.

Get FIFA World Cup Player Average Positions - Get FIFA World Cup player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Requires GOAT tier.

Get FIFA World Cup Pre-match Team Form - Get FIFA World Cup pre-match team form Retrieve a pre-match team form summary (recent average rating, position, and a five-character form string per side). Requires GOAT tier.

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

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

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

Get La Liga Player Injuries - Get La Liga player injuries Retrieve the current La Liga player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get La Liga Standings - Get La Liga standings Get league standings for a specific season

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

Get La Liga Match Events - Get La Liga match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get La Liga Match Lineups - Get La Liga match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get La Liga Player Match Statistics - Get La Liga player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get La Liga Team Match Statistics - Get La Liga team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get La Liga Betting Odds - Get La Liga betting odds Retrieve betting odds for La Liga matches. Supports filtering by match IDs or dates. La Liga odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get La Liga Opening Betting Odds - Get La Liga opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get La Liga Player Prop Betting Odds - Get La Liga player prop betting odds Retrieve live player prop betting data for La Liga matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get La Liga Opening Player Prop Odds - Get La Liga opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get La Liga Match Shots - Get La Liga match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get La Liga Match Attack Momentum - Get La Liga match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get La Liga Match Top Performers - Get La Liga match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get La Liga Player Average Positions - Get La Liga player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get La Liga Player Heatmaps - Get La Liga player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get La Liga Pre-match Team Form - Get La Liga pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

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

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

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

Get Ligue 1 Player Injuries - Get Ligue 1 player injuries Retrieve the current Ligue 1 player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get Ligue 1 Standings - Get Ligue 1 standings Get league standings for a specific season

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

Get Ligue 1 Match Events - Get Ligue 1 match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get Ligue 1 Match Lineups - Get Ligue 1 match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get Ligue 1 Player Match Statistics - Get Ligue 1 player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get Ligue 1 Team Match Statistics - Get Ligue 1 team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get Ligue 1 Betting Odds - Get Ligue 1 betting odds Retrieve betting odds for Ligue 1 matches. Supports filtering by match IDs or dates. Ligue 1 odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get Ligue 1 Opening Betting Odds - Get Ligue 1 opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Ligue 1 Player Prop Betting Odds - Get Ligue 1 player prop betting odds Retrieve live player prop betting data for Ligue 1 matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get Ligue 1 Opening Player Prop Odds - Get Ligue 1 opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Ligue 1 Match Shots - Get Ligue 1 match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get Ligue 1 Match Attack Momentum - Get Ligue 1 match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 Match Top Performers - Get Ligue 1 match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 Player Average Positions - Get Ligue 1 player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Ligue 1 Player Heatmaps - Get Ligue 1 player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get Ligue 1 Pre-match Team Form - Get Ligue 1 pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get All LOL Teams - Get all LOL teams Retrieve a list of all professional League of Legends teams

Get All LOL Players - Get all LOL players Retrieve a list of all professional League of Legends players

Get All LOL Champions - Get all LOL champions Retrieve a list of all League of Legends champions

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

Get All LOL Summoner Spells - Get all LOL summoner spells Retrieve a list of all League of Legends summoner spells

Get All LOL Rune Paths - Get all LOL rune paths Retrieve a list of all League of Legends rune paths (Domination, Inspiration, Precision, Resolve, Sorcery)

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

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

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

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

Get Champion Statistics - Get champion statistics Retrieve aggregate statistics for LOL champions across professional matches. Requires ALL-STAR tier or higher.

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

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

Get Player Match Map Statistics - Get player match map statistics Retrieve detailed player statistics for individual games. Requires GOAT tier.

Get Team Match Map Statistics - Get team match map statistics Retrieve detailed team statistics for individual games. Requires GOAT tier.

Get Player Overall Statistics - Get player overall statistics Retrieve career statistics for LOL players. Requires GOAT tier.

Get MLB Teams - Get MLB teams

Get Specific MLB Team - Get specific MLB team

Get MLB Players - Get MLB players

Get Specific MLB Player - Get specific MLB player

Get MLB Player Injuries - Get MLB player injuries

Get Active MLB Players - Get active MLB players

Get MLB Games - Get MLB games

Get Specific MLB Game - Get specific MLB game

Get MLB Stats - Get MLB stats

Get MLB Team Standings - Get MLB team standings

Get MLB Season Stats - Get MLB season stats

Get MLB Team Season Stats - Get MLB team season stats

Get MLB 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 - Get MLB player vs player matchups Get head-to-head batting statistics for batter against pitchers for a specific team, or pitcher against batters from a specific team

Get MLB Play-by-play Data - Get MLB play-by-play data Returns play-by-play data for a specific game including game state, scoring plays, and batted ball details. Plays are ordered by `order` ascending by default. Set `sort_order=desc` to return the latest plays first. Keep the same `sort_order` when following pagination cursors.

Get MLB Plate Appearance Data - Get MLB plate appearance data Returns plate appearance data for a specific game. Each plate appearance includes the outcome and all individual pitches with detailed advanced pitch metrics. All plate appearances for the game are returned in a single response (no pagination).

Get MLB Pitcher Pitch Type Game Stats - Get MLB pitcher pitch type game stats Returns per-game pitcher pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB Hitter Pitch Type Game Stats - Get MLB hitter pitch type game stats Returns per-game hitter pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB Pitcher Pitch Type Season Stats - Get MLB pitcher pitch type season stats Returns season-level pitcher pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB Hitter Pitch Type Season Stats - Get MLB hitter pitch type season stats Returns season-level hitter pitch-type usage, command, whiff/contact, and damage metrics.

Get MLB Betting Odds - Get MLB betting odds Retrieve betting odds for MLB games. Either dates or game_ids is required.

Get All Current MLB Betting Markets - Get all current MLB betting markets Retrieve the current market catalog for one MLB game. This open-ended endpoint includes game, team, inning, player, comparison, milestone, and other market structures without requiring market names or keys to come from a fixed list. Complete current catalogs are available for DraftKings and FanDuel. Sportsbooks supported by the simplified odds or player-props endpoints may not appear here until complete market catalogs are available. Markets are paginated as complete units. Outcomes may have null prices while their status is `locked` or `suspended`. Use `/mlb/v1/odds/player_props` when you only need the simplified single-player over/under and milestone projection.

Get MLB Opening Betting Odds - Get MLB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLB Player Prop Betting Odds - Get MLB player prop betting odds Retrieve live player prop betting data for MLB games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Prop types are open-ended. Common examples include: - Batter props: hits, home_runs, total_bases, rbis, stolen_bases, singles, doubles, triples, walks, strikeouts, runs_scored, and hits_runs_rbis - Pitcher props: pitcher_strikeouts, pitcher_outs, pitcher_hits_allowed, pitcher_walks, pitcher_earned_runs, and pitcher_record_a_win Newly available compatible single-player markets can appear without a documentation enum update. Use `/mlb/v1/odds/markets` for the complete current market catalog, including structures that do not fit this simplified response. Available vendors: betmgm, betrivers, caesars, draftkings, fanatics, fanduel

Get MLB Opening Player Prop Odds - Get MLB opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLB DFS Slates - Get MLB DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games. Use the slate detail endpoint for included events and roster slots, then request draftables for selectable players or teams and their slate-specific salaries. Requires GOAT tier. Current slates are returned by default; use active=false for inactive historical snapshots.

Get A MLB DFS Slate - Get a MLB DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available. The active flags preserve the state of historical slate members. Requires GOAT tier.

Get MLB DFS Draftables - Get MLB DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available. game_id, player_id, or team_id can be null when no reference is available. Current draftables are returned by default; use active=false for inactive history. Requires GOAT tier.

Get MLB Game Lineups - Get MLB game lineups Get pre-game batting lineups and probable pitchers for MLB games. Lineups typically appear 1-2 hours before first pitch. Lineup data is available starting from the 2026 season.

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

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

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

Get MLS Player Injuries - Get MLS player injuries Retrieve the current MLS player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

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

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

Get MLS Match Events - Get MLS match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get MLS Match Lineups - Get MLS match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get MLS Player Match Statistics - Get MLS player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get MLS Team Match Statistics - Get MLS team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get MLS Betting Odds - Get MLS betting odds Retrieve betting odds for MLS matches. Supports filtering by match IDs or dates. MLS odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get MLS Opening Betting Odds - Get MLS opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLS Player Prop Betting Odds - Get MLS player prop betting odds Retrieve live player prop betting data for MLS matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get MLS Opening Player Prop Odds - Get MLS opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get MLS Match Shots - Get MLS match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get MLS Match Attack Momentum - Get MLS match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get MLS Match Top Performers - Get MLS match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get MLS Player Average Positions - Get MLS player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get MLS Player Heatmaps - Get MLS player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get MLS Pre-match Team Form - Get MLS pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

Get All MMA 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 - Get specific MMA league Retrieve details for a specific MMA league

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

Get Specific MMA Event - Get specific MMA event Retrieve metadata for a specific MMA event. Fights are not embedded; retrieve the paginated card with /mma/v1/fights?event_ids[]=159824.

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

Get Specific MMA Fighter - Get specific MMA fighter Retrieve details for a specific MMA fighter

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

Get Specific MMA Fight - Get specific MMA fight Retrieve details for a specific MMA fight

Get MMA Rankings - Get MMA rankings Retrieve all current fighter rankings grouped by weight class and league. This endpoint does not support query filters or a rankings/{id} endpoint.

Get MMA Fight Statistics - Get MMA fight statistics Retrieve detailed fight statistics for fighters

Get Specific Fight Statistics - Get specific fight statistics Retrieve statistics for a specific fight performance

Get MMA 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 - Get MMA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NBA Teams - Get NBA teams

Get Specific NBA Team - Get specific NBA team

Get NBA Players - Get NBA players

Get Specific NBA Player - Get specific NBA player

Get NBA Games - Get NBA games

Get Specific NBA Game - Get specific NBA game

Get NBA Stats - Get NBA stats

Get NBA Season Averages - Get NBA season averages

Get NBA Season Averages By Type - Get NBA season averages by type

Get NBA Team Season Averages By Category - Get NBA team season averages by category Retrieve team season averages for various statistical categories. Each category requires a specific type parameter that determines the exact stats returned. The hustle category does not require a type parameter. **Available category/type combinations:** - general: base, advanced, scoring, misc, opponent, defense, violations - clutch: base, advanced, misc, scoring - shooting: by_zone_base, by_zone_opponent, 5ft_range_base, 5ft_range_opponent - playtype: cut, handoff, isolation, offrebound, offscreen, postup, prballhandler, prrollman, spotup, transition, misc - tracking: painttouch, efficiency, speeddistance, defense, elbowtouch, posttouch, passing, drives, rebounding, catchshoot, pullupshot, possessions - hustle: (no type parameter required) - shotdashboard: overall, pullups, catch_and_shoot, less_than_10_ft

Get NBA Team Standings - Get NBA team standings

Get Active NBA Players - Get active NBA players

Get NBA Player Injuries - Get NBA player injuries

Get Live NBA Box Scores - Get live NBA box scores

Get NBA Box Scores For A Specific Date - Get NBA box scores for a specific date

Get NBA Game Lineups - Get NBA game lineups Retrieve starting lineups and bench players for NBA games. **Important Notes:** - Lineup data is only available starting from the 2025 NBA season - Lineup data is only available once the game begins

Get NBA Stat Leaders - Get NBA stat leaders

Get NBA Betting Odds - Get NBA betting odds Retrieve betting odds for NBA games, including preseason games when odds are available. Either dates or game_ids is required.

Get NBA Opening Betting Odds - Get NBA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NBA Player Prop Betting Odds - Get NBA player prop betting odds Retrieve live player prop betting data for NBA games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, betway, betrivers, ballybet, betparx, caesars, fanduel, rebet

Get NBA Opening Player Prop Odds - Get NBA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NBA Advanced Stats (V2) - Get NBA advanced stats (V2) Retrieve comprehensive advanced statistics for NBA player performances. This V2 endpoint includes additional metrics from tracking data, hustle stats, defensive matchups, and usage analytics. Includes data from: - Box score advanced (PIE, ratings, efficiency metrics) - Box score misc (fast break points, second chance points) - Box score scoring (shot distribution percentages) - Four factors (effective FG%, turnover rate) - Hustle stats (deflections, contested shots, loose balls) - Defensive matchups (matchup FG%, points allowed) - Player tracking (speed, distance, touches) - Usage stats (percentage of team stats)

Get NBA Player Contracts By Team - Get NBA player contracts by team Returns all player contracts for a specific team and season. Season defaults to current season if not specified.

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

Get Aggregated NBA Player Contract Data - Get aggregated NBA player contract data Returns multi-year contract aggregates for a specific player, including total value, guarantees, and contract metadata.

Get NBA DFS Slates - Get NBA DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games. Use the slate detail endpoint for included events and roster slots, then request draftables for selectable players or teams and their slate-specific salaries. Requires GOAT tier. Current slates are returned by default; use active=false for inactive historical snapshots.

Get A NBA DFS Slate - Get a NBA DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available. The active flags preserve the state of historical slate members. Requires GOAT tier.

Get NBA DFS Draftables - Get NBA DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available. game_id, player_id, or team_id can be null when no reference is available. Current draftables are returned by default; use active=false for inactive history. Requires GOAT tier.

Get NBA Play-by-play Data - Get NBA play-by-play data Retrieve play-by-play data for an NBA game. Returns all plays for a game in chronological order, including shot attempts, turnovers, fouls, and other game events. Each play includes the game clock, score, and team information.

Get NCAAB Conferences - Get NCAAB conferences

Get Specific NCAAB Conference - Get specific NCAAB conference

Get NCAAB Teams - Get NCAAB teams

Get Specific NCAAB Team - Get specific NCAAB team

Get NCAAB Players - Get NCAAB players

Get Specific NCAAB Player - Get specific NCAAB player

Get Active NCAAB Players - Get active NCAAB players

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

Get NCAAB 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 - Get specific NCAAB game

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

Get NCAAB Play-by-play Data - Get NCAAB play-by-play data

Get NCAAB Player Game Statistics - Get NCAAB player game statistics Get player statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB Team Game Statistics - Get NCAAB team game statistics Get team statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB Player Season Statistics - Get NCAAB player season statistics Get player season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB Team Season Statistics - Get NCAAB team season statistics Get team season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAB Tournament Bracket Data - Get NCAAB tournament bracket data Retrieve NCAA Men's Basketball tournament bracket data with optional filters (GOAT tier). Seasons are identified by their starting year (e.g. 2025 for the 2025-26 season). Round IDs: - 1: First Four/Play-in games - 2: Round of 64 (First Round) - 3: Round of 32 (Second Round) - 4: Sweet 16 (Regional Semifinals) - 5: Elite 8 (Regional Finals) - 6: Final Four (National Semifinals) - 7: Championship (National Championship)

Get NCAAB Betting Odds - Get NCAAB betting odds Retrieve betting odds for NCAAB games. Either dates or game_ids is required.

Get NCAAB Opening Betting Odds - Get NCAAB opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NCAAF Conferences - Get NCAAF conferences

Get Specific NCAAF Conference - Get specific NCAAF conference

Get NCAAF Teams - Get NCAAF teams

Get Specific NCAAF Team - Get specific NCAAF team

Get NCAAF Players - Get NCAAF players

Get Active NCAAF Players - Get active NCAAF players

Get Specific NCAAF Player - Get specific NCAAF player

Get NCAAF Standings - Get NCAAF standings

Get NCAAF Games - Get NCAAF games

Get Specific NCAAF Game - Get specific NCAAF game

Get NCAAF Rankings - Get NCAAF rankings

Get NCAAF Play-by-play Data - Get NCAAF play-by-play data

Get NCAAF Player Statistics - Get NCAAF player statistics

Get NCAAF Team Statistics - Get NCAAF team statistics

Get NCAAF Player Season Statistics - Get NCAAF player season statistics

Get NCAAF Team Season Statistics - Get NCAAF team season statistics

Get NCAAF 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 - Get NCAAF opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Current NCAAF Player Prop Odds - Get current NCAAF player prop odds Retrieve current pre-game and live player prop betting odds. Sportsbook availability varies by game and market, and markets may be removed as a game progresses. The response is not paginated. Requires GOAT tier. Supported prop types are `passing_yards`, `passing_tds`, `rushing_yards`, `receiving_yards`, and `anytime_td`. Retained opening prices are available separately from the opening player-props endpoint.

Get NCAAF Opening Player Prop Odds - Get NCAAF opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NCAAW Conferences - Get NCAAW conferences

Get Specific NCAAW Conference - Get specific NCAAW conference

Get NCAAW Teams - Get NCAAW teams

Get Specific NCAAW Team - Get specific NCAAW team

Get NCAAW Players - Get NCAAW players

Get Specific NCAAW Player - Get specific NCAAW player

Get Active NCAAW Players - Get active NCAAW players

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

Get NCAAW 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 - Get specific NCAAW game

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

Get NCAAW Play-by-play Data - Get NCAAW play-by-play data

Get NCAAW Player Game Statistics - Get NCAAW player game statistics Get player statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW Team Game Statistics - Get NCAAW team game statistics Get team statistics. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW Player Season Statistics - Get NCAAW player season statistics Get player season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW Team Season Statistics - Get NCAAW team season statistics Get team season averages. Note - season values are transformed (user sends 2025, API queries DB for 2026, returns 2025)

Get NCAAW Tournament Bracket Data - Get NCAAW tournament bracket data Retrieve NCAA Women's Basketball tournament bracket data with optional filters (GOAT tier). Seasons are identified by their starting year (e.g. 2025 for the 2025-26 season). Round IDs: - 0: First Four/Play-in games - 1: Round of 64 (First Round) - 2: Round of 32 (Second Round) - 3: Sweet 16 (Regional Semifinals) - 4: Elite 8 (Regional Finals) - 5: Final Four (National Semifinals) - 6: Championship (National Championship)

Get NCAAW Betting Odds - Get NCAAW betting odds Retrieve betting odds for NCAAW games. Either dates or game_ids is required. Note that NCAAW odds data is sparse — coverage is limited compared to other sports, and not all games will have odds available. Data is only available from the 2025-2026 season onwards.

Get NCAAW Opening Betting Odds - Get NCAAW opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NFL Player Designations - Get NFL player designations Requires GOAT access. Returns one row per player and game in the selected week. Supply season and week together; season_types defaults to [2] for an explicit week. When all three are omitted, the next unfinished game determines the current season, phase, and week, excluding canceled and postponed games. season_types requires season and week. Teams on bye have no rows. Historical coverage varies by game and field.

Get NFL Teams - Get NFL teams

Get Specific NFL Team - Get specific NFL team

Get NFL Team Roster - Get NFL team roster Retrieve the current roster and depth chart for a specific NFL team. Note: Roster data is only available starting with the 2025 season.

Get NFL Players - Get NFL players

Get Specific NFL Player - Get specific NFL player

Get Active NFL Players - Get active NFL players

Get NFL Games - Get NFL games

Get Specific NFL Game - Get specific NFL game

Get NFL Stats - Get NFL stats

Get NFL Team Standings - Get NFL team standings

Get NFL Player Injuries - Get NFL player injuries

Get NFL Season Stats - Get NFL season stats Season totals are unavailable before the first kickoff of the requested season type, so the data array is empty. Rushing and receiving fumble counts cover those play types only. Use game stats for all-play fumble counts; null means unavailable, not zero.

Get NFL Advanced Rushing Stats - Get NFL advanced rushing stats

Get NFL Advanced Passing Stats - Get NFL advanced passing stats

Get NFL Advanced Receiving Stats - Get NFL advanced receiving stats

Get NFL Betting Odds - Get NFL betting odds Retrieve betting odds for NFL games, including preseason. Either (season and week) or game_ids is required. Week queries default to regular season and postseason; use season_types[]=1 for preseason. A preseason game_id can be queried directly without season_types.

Get NFL Opening Betting Odds - Get NFL opening betting odds Retrieve historical opening betting odds, including preseason when available. Week queries default to regular season and postseason; use season_types[]=1 for preseason. Requires GOAT tier.

Get NFL Player Prop Betting Odds - Get NFL player prop betting odds Retrieve live player prop betting data for NFL games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Sportsbook availability varies by game and market. Use the vendor values returned by the endpoint.

Get NFL Opening Player Prop Odds - Get NFL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NFL Team Season Stats - Get NFL team season stats Retrieve comprehensive team season statistics including offense, defense, special teams, and opponent stats

Get NFL Team Game Stats - Get NFL team game stats Retrieve team statistics for individual games

Get NFL Fantasy Scoring Formats - Get NFL fantasy scoring formats Returns season-specific scoring definitions referenced by available fantasy data. The flexible rules object supports standard, PPR, half-PPR, and future scoring structures without changing the response envelope. `scoring_format` filters the returned definitions directly. Requires NFL GOAT tier.

Get NFL Fantasy Projections - Get NFL fantasy projections Returns season projections when `week` is omitted and weekly lineup projections with game context when `week` is supplied. `scoring_format` selects the score used to filter and order records (PPR by default), while every returned entity includes all available scoring variants. Use `date` for an exact historical snapshot. Requires NFL GOAT tier.

Get NFL Weekly Fantasy Stats - Get NFL weekly fantasy stats Returns observed weekly player or team-defense statistics, game context, and fantasy-point totals for every available scoring variant. `scoring_format` selects the score used to filter and order records (PPR by default). A `week` is required. This endpoint covers regular-season weeks 1 through 18 only and does not accept a postseason filter. Updates are periodic rather than real time, and records can change during an in-progress game when newer results become available. `collected_at` is the collection time, not the game completion time; historical records loaded together can share the same value. There is no fixed post-final availability time. Requires NFL GOAT tier. ### Weekly stats and scoring contract Weekly stats are the latest available observations, not a finalized DFS settlement feed. The supplied Standard, Half PPR, and PPR formats are not DraftKings contest rules. **Identity and missing values.** There is at most one current D/ST record per season, week, and team, linked to its game; a row is not guaranteed for every team or game. `player` is null for D/ST. Corrections update the current record in place rather than creating a revision record. This endpoint does not expose dated revisions. `stats` is a sparse numeric map for both players and D/ST. An explicit zero is a reported numeric value. An absent key contributes zero to the published fantasy-points calculation, but is not a guarantee that the event did not occur or that collection is complete. There is no per-key availability flag to distinguish an omitted zero from an unavailable observation. The season-stat rule about nullable fields does not make weekly key omission equivalent to a reported null. This applies equally to two-point conversions, `fumbles_lost`, return touchdowns, and `offensive_fumble_recovery_touchdowns`. **D/ST counters.** D/ST values are team-level fantasy observations, not a sum that clients should reconstruct from player rows. The following names describe the reported categories; they do not guarantee complete coverage of every return role or event: | Stat keys | Reported category | | --- | --- | | `defensive_sacks`, `defensive_interceptions`, `defensive_safeties` | Sacks, interceptions, and safeties credited to the defense. | | `opponent_fumble_recoveries`, `kicks_blocked` | Opponent fumbles recovered and blocked kicks. | | `interception_return_touchdowns`, `fumble_return_touchdowns`, `blocked_kick_return_touchdowns` | Touchdowns classified by the indicated return type. | | `kick_return_touchdowns`, `punt_return_touchdowns` | Kickoff and punt return touchdowns. | | `two_point_returns`, `one_point_safeties` | Conversion returns worth two points and one-point safeties. | | `offensive_fumble_recovery_touchdowns` | Offensive fumble recoveries for touchdowns; not interchangeable with defensive fumble-return touchdowns. | The API does not provide event identifiers or a guarantee that all touchdown fields are mutually exclusive. A player's return can also be credited to the team's D/ST row; do not add player and team rows to produce a team total. An exhaustive return-role and event-overlap dictionary is not currently available. **Points and yards allowed.** `points_allowed` is the reported points-allowed counter; `dst_points_allowed` is a separate reported D/ST points-allowed counter. Their equality in a particular game does not make them aliases. Neither field has a guaranteed DraftKings points-allowed definition. In particular, this endpoint does not specify an inclusion/exclusion contract for offensive scores, interception/fumble return touchdowns against, kickoff/punt return touchdowns against, blocked-kick returns, safeties, extra points, or one- and two-point conversion returns. Do not infer these rules from the final scoreboard or from the `dst_` prefix. To reproduce a supplied format, use the stat keys in that format's rules; those may use `points_allowed_*` rather than `dst_points_allowed_*`. Bucket values are supplied observations, not recomputed by this endpoint from the raw counters. For observed weekly stats they represent range indicators: `X_to_Y` names inclusive endpoints, `under_100` means less than 100, and `550_plus` means at least 550. The same naming applies to `points_allowed_*`, `dst_points_allowed_*`, and `yards_allowed_*`. Do not assume a scoring-rule list enumerates every available bucket. For example, `points_allowed_18_to_21`, `points_allowed_22_to_27`, and `yards_allowed_300_to_349` can be present even when the format has no rule for them. Such ranges contribute no bucket points under that format; this does not imply all buckets in `stats` are zero. **Calculating totals.** For each rule item, multiply `stats[item.stat]` (zero if absent) by `position_points[position]` when that override exists, otherwise by `points`, then sum the contributions. An override replaces the base value; it does not add to it. For example, `points=6` and `position_points.DST=6` awards six points per event, not twelve. `is_reverse` is descriptive rule metadata and does not apply another sign change in this calculation. Negative scoring is expressed by the effective points value. Each `fantasy_points` entry embeds its season-specific scoring format. `derived=true` indicates a format calculated from another definition; derived Half PPR retains Standard's other rules and scores receptions at 0.5. `rules.schema_version` versions the rule structure, not the stats dictionary. Totals are calculated from the numeric stats using the associated rules and are stored values, not recalculated when you request the endpoint. There is no atomic revision token covering stats, totals, and rules during an update; compare them again on a subsequent fetch if they temporarily differ. For example, Buffalo's 2025 week 1 D/ST row for game 423959 has 2 sacks, 1 opponent fumble recovery, the 35–45 points-allowed bucket, and the 400–449 yards-allowed bucket. The supplied formats score these as `2 + 2 - 3 - 3 = -2`. **Freshness and completeness.** `collected_at` is collection time, not a strictly monotonic sequence or a content revision identifier. Equal timestamps are not a guarantee of identical values. Corrections can appear after the game ends. `game.status_state=final` describes the game, not completion of the stat population; there is no separate completeness or correction-finality signal. A versioned, exhaustive stats-map data dictionary is not currently exposed.

Get NFL Fantasy Rankings - Get NFL fantasy rankings Returns fantasy ranking variants, position ranks, and auction values. The `ranking_type` parameter selects the rank used to filter and order records (PPR by default), while every returned entity includes all available ranking variants. Use `date` for an exact historical snapshot. Requires NFL GOAT tier.

Get NFL Fantasy ADP And Ownership Data - Get NFL fantasy ADP and ownership data Returns average draft position, auction value, rostered and started percentages, and their available changes. Results are ordered by average draft position. Use `date` for an exact historical snapshot. Requires NFL GOAT tier.

Get NFL DFS Slates - Get NFL DFS slates Returns provider-neutral daily fantasy lineup pools and rules. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games. Use the slate detail endpoint for included events and roster slots, then request draftables for selectable players or teams and their slate-specific salaries. Requires GOAT tier. Current slates are returned by default; use active=false for inactive historical snapshots.

Get A NFL DFS Slate - Get a NFL DFS slate Returns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available. The active flags preserve the state of historical slate members. Requires GOAT tier.

Get NFL DFS Draftables - Get NFL DFS draftables Returns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available. game_id, player_id, or team_id can be null when no reference is available. Current draftables are returned by default; use active=false for inactive history. Requires GOAT tier.

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

Get NHL Teams - Get NHL teams

Get Specific NHL Team - Get specific NHL team

Get NHL Team Season Statistics - Get NHL team season statistics

Get NHL Players - Get NHL players

Get NHL Player Season Statistics - Get NHL player season statistics

Get NHL Games - Get NHL games

Get NHL Standings - Get NHL standings

Get NHL Box Scores - Get NHL box scores

Get NHL Play-by-play Data - Get NHL play-by-play data Returns play-by-play data for a specific game. Plays are returned in chronological order with a sequential order field starting from 1.

Get All Currently Injured NHL Players - Get all currently injured NHL players Returns all players currently on the injury report. The data is updated regularly to reflect the latest injury reports.

Get NHL Player Statistical Leaders - Get NHL player statistical leaders

Get NHL Team Statistical Leaders - Get NHL team statistical leaders

Get NHL Betting Odds - Get NHL betting odds Retrieve betting odds for NHL games. Either dates or game_ids is required.

Get NHL Opening Betting Odds - Get NHL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get NHL Player Prop Betting Odds - Get NHL player prop betting odds Retrieve live player prop betting data for NHL games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: fanduel, draftkings, betmgm, caesars, betrivers (more coming soon!)

Get NHL Opening Player Prop Odds - Get NHL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

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

Get PGA Tour Tournaments (v1) - Get PGA Tour tournaments (v1) Deprecated for new integrations. Use `/pga/v2/tournaments`, which provides normalized dates and optional format information. This v1 route remains operational for existing integrations. Free tier.

Get PGA Tour Tournaments - Get PGA Tour tournaments Retrieve tournaments with normalized date fields. Set include_format=true to add format_type without changing the default response shape. Free tier.

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

Get Format-aware Tournament Results - Get format-aware tournament results Retrieve the primary result population for one tournament. PLAYER rows are returned for stroke and match play, TEAM rows for team stroke, and CUP_TEAM rows for team cup. Requires ALL-STAR tier.

Get Tournament Rounds - Get tournament rounds Retrieve every known round and its round-specific format for one tournament. Free tier. This endpoint is not paginated.

Get Format-aware Tee Groups - Get format-aware tee groups Retrieve tee groups with complete participant arrays. Pairings and match relationships are preserved when available. Requires GOAT tier.

Get Tournament Matches - Get tournament matches Retrieve match-play or team-cup matches with complete side arrays. Returns an empty data array when matches do not apply or are not available. Requires ALL-STAR tier.

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

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

Get PGA Tournament Results - Get PGA tournament results Deprecated for new integrations. Use `/pga/v2/tournament_results` for format-aware player, team, and cup-team results. This v1 route remains operational for existing integrations. Requires ALL-STAR tier.

Get PGA Tournament Field - Get PGA tournament field Deprecated for new integrations. Use `/pga/v2/tournament_competitors` for players, teams, pairings, and cup rosters. This v1 route remains operational for existing integrations. Requires GOAT tier.

Get PGA Tee Times - Get PGA tee times Deprecated for new integrations. Use `/pga/v2/tee_times` for format-aware tee groups and complete participant arrays. This v1 route remains operational for existing integrations. Requires GOAT tier.

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

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

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

Get Player Round Statistics - Get player round statistics Retrieve detailed player round statistics including strokes gained. Use round_number=-1 for tournament totals. Requires GOAT tier.

Get Player Season Statistics - Get player season statistics Retrieve player season-level statistics. Requires GOAT tier.

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

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

Get PGA Player Props - Get PGA player props Retrieve player prop betting odds for a PGA tournament (e.g., round scores, hole scores, birdies). Requires GOAT tier.

Get PGA Tour Opening Player Prop Odds - Get PGA Tour opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

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

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

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

Get Serie A Player Injuries - Get Serie A player injuries Retrieve the current Serie A player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get Serie A Standings - Get Serie A standings Get league standings for a specific season

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

Get Serie A Match Events - Get Serie A match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get Serie A Match Lineups - Get Serie A match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get Serie A Player Match Statistics - Get Serie A player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get Serie A Team Match Statistics - Get Serie A team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get Serie A Betting Odds - Get Serie A betting odds Retrieve betting odds for Serie A matches. Supports filtering by match IDs or dates. Serie A odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get Serie A Opening Betting Odds - Get Serie A opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Serie A Player Prop Betting Odds - Get Serie A player prop betting odds Retrieve live player prop betting data for Serie A matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get Serie A Opening Player Prop Odds - Get Serie A opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get Serie A Match Shots - Get Serie A match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get Serie A Match Attack Momentum - Get Serie A match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Serie A Match Top Performers - Get Serie A match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get Serie A Player Average Positions - Get Serie A player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get Serie A Player Heatmaps - Get Serie A player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get Serie A Pre-match Team Form - Get Serie A pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

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

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

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

Get UCL Player Injuries - Get UCL player injuries Retrieve the current UCL player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.

Get UCL Standings - Get UCL standings Get league standings for a specific season

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

Get UCL Match Events - Get UCL match events Get match events (goals, cards, substitutions, etc.) with optional filtering by matches. Supports pagination.

Get UCL Match Lineups - Get UCL match lineups Get match lineups (starting and substitute players) with optional filtering by matches. Supports pagination.

Get UCL Player Match Statistics - Get UCL player match statistics Get player match statistics with optional filtering by matches or players. Supports pagination.

Get UCL Team Match Statistics - Get UCL team match statistics Get team match statistics with optional filtering by matches or teams. Supports pagination.

Get UCL Betting Odds - Get UCL betting odds Retrieve betting odds for UCL matches. Supports filtering by match IDs or dates. UCL odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals). Supports pagination.

Get UCL Opening Betting Odds - Get UCL opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get UCL Player Prop Betting Odds - Get UCL player prop betting odds Retrieve live player prop betting data for UCL matches. Player prop data is LIVE and updated in real-time. We do not store historical data. As matches near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified match in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement Available vendors: draftkings, fanduel, caesars (more coming soon!)

Get UCL Opening Player Prop Odds - Get UCL opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

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

Get UCL Match Shots - Get UCL match shots Retrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results. Requires GOAT tier.

Get UCL Match Attack Momentum - Get UCL match attack momentum Retrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL Match Top Performers - Get UCL match top performers Retrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL Player Average Positions - Get UCL player average positions Retrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only. Requires GOAT tier.

Get UCL Player Heatmaps - Get UCL player heatmaps Retrieve per-player heatmap dots for a match. Heatmap data is published only after a match concludes; in-progress matches return zero heatmap rows, with data landing within ~20 minutes of full-time. Requires GOAT tier.

Get UCL Pre-match Team Form - Get UCL pre-match team form Retrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results. Available for matches in the current and future seasons only. Requires GOAT tier.

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

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

List Tournament Series - List tournament series Returns tournament series. Requires Free tier or higher.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

List Maps For A Match - List maps for a match Returns the individual maps played in one match. Requires GOAT tier or higher.

List Live Match Snapshots - List live match snapshots Returns the latest available live snapshot for current matches, including player state. The collection is empty when no matching live snapshot is available. Requires GOAT tier or higher. Live snapshots update while coverage is active. Use the completed-match endpoints for finalized statistics.

List Aggregate Player Statistics - List aggregate player statistics Returns career aggregate statistics for competitive player profiles. Requires GOAT tier or higher.

List Player Statistics For A Match - List player statistics for a match Returns finalized aggregate player statistics for one completed match. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while a match is live.

List Player Statistics For A Match Map - List player statistics for a match map Returns player statistics for one match map. Live snapshots have is_final=false and snapshot_at populated; finalized rows have is_final=true. Requires GOAT tier or higher. During live coverage, completion-only fields can be null. Finalized statistics replace the provisional representation after completion.

List Rounds For A Match Map - List rounds for a match map Returns rounds for one match map. Live snapshots have is_final=false and snapshot_at populated; finalized rows have is_final=true. Requires GOAT tier or higher. Provisional round details are available during covered live maps and are replaced by finalized details after completion.

List Player Statistics For A Round - List player statistics for a round Returns finalized player statistics for one round. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while the map is live.

List Team Statistics For A Round - List team statistics for a round Returns finalized team statistics for one round. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while the map is live.

List Player Weapon Statistics For A Match - List player weapon statistics for a match Returns finalized player kill totals by weapon for one match. Requires GOAT tier or higher. This endpoint is completion-only and can return an empty data array while a match is live.

Get WNBA Teams - Get WNBA teams

Get Specific WNBA Team - Get specific WNBA team

Get WNBA Players - Get WNBA players

Get Active WNBA Players - Get active WNBA players

Get Specific WNBA Player - Get specific WNBA player

Get WNBA Games - Get WNBA games

Get Specific WNBA Game - Get specific WNBA game

Get WNBA Player Statistics - Get WNBA player statistics

Get WNBA Team Statistics - Get WNBA team statistics

Get WNBA Player Season Statistics - Get WNBA player season statistics

Get WNBA Team Season Statistics - Get WNBA team season statistics

Get WNBA Player Game Advanced Statistics - Get WNBA player game advanced statistics

Get WNBA Team Game Advanced Statistics - Get WNBA team game advanced statistics

Get WNBA Player Season Advanced Statistics - Get WNBA player season advanced statistics

Get WNBA Team Season Advanced Statistics - Get WNBA team season advanced statistics

Get WNBA Player Shot Location Statistics - Get WNBA player shot location statistics

Get WNBA Team Shot Location Statistics - Get WNBA team shot location statistics

Get WNBA Standings - Get WNBA standings

Get WNBA Player Injuries - Get WNBA player injuries

Get WNBA Betting Odds - Get WNBA betting odds Retrieve betting odds for WNBA games. Either dates or game_ids is required.

Get WNBA Opening Betting Odds - Get WNBA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get WNBA Player Prop Betting Odds - Get WNBA player prop betting odds Retrieve live player prop betting data for WNBA games. Player prop data is LIVE and updated in real-time. We do not store historical data. As games near completion, many (or all) player props may be removed from sportsbooks. **Note:** This endpoint returns all player props for the specified game in a single response. Pagination is not supported. The API supports two market types: - **over_under**: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value - **milestone**: Milestone markets where users bet on whether a player will reach a specific achievement

Get WNBA Opening Player Prop Odds - Get WNBA opening player prop odds Retrieve historical opening player prop betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get WNBA Play-by-play Data - Get WNBA play-by-play data

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

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

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

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

Get WTA Rankings - Get WTA rankings Retrieve current WTA rankings. Free tier.

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

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

Get WTA Player Career Statistics - Get WTA player career statistics Retrieve career statistics for WTA players. Requires GOAT tier.

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

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

Get WTA Opening Betting Odds - Get WTA opening betting odds Retrieve historical opening betting odds. Coverage is limited to the most recently completed season and ongoing seasons where available. Requires GOAT tier.

Get WTA Match Statistics - Get WTA match statistics Retrieve detailed match statistics. Requires GOAT tier.

Get Team Contracts - Retrieve every player contract on a single NBA team for a season.

Get Player Contracts - Retrieve a single player's contracts, optionally narrowed to specific seasons.

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

List DFS Slates - Retrieve provider-neutral daily fantasy sports slates, with their format, event window, salary cap and single or multi-game scope.

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

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

Get All Games - Retrieve NBA games filtered by date, date range, season, season type or team.

Get A Specific Game - Retrieve a single NBA game by its BALLDONTLIE game ID.

Get Box Scores - Retrieve complete box scores for every NBA game played on a specific date.

Get Live Box Scores - Retrieve live box scores for NBA games currently in progress.

Get Game Lineups - Retrieve starting lineups and bench players for one or more NBA games.

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

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 - Retrieve the historical opening game-level betting odds for NBA games by date or game ID.

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 - Retrieve the historical opening player prop betting lines for a single NBA game.

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

Get A Specific Player - Retrieve a single NBA player by their BALLDONTLIE player ID.

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 - Retrieve current NBA injury reports, optionally filtered by team or player.

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

Get Averages - Retrieve player season averages for a statistical category — general, clutch, defense or shooting — with a specific split selected by type.

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

Get All Advanced Stats (V2) - Retrieve advanced per-game player statistics including efficiency ratings, tracking data, hustle stats, defensive matchups and usage.

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

Get All Teams - Retrieve all NBA teams, optionally narrowed to a single division or conference.

Get A Specific Team - Retrieve a single NBA team by its BALLDONTLIE team ID.

Get Team Standings - Retrieve NBA team standings for a season, including conference and division records.

Get Team Season Averages - Retrieve team-level season averages for a statistical category, such as general, clutch, shooting, playtype, tracking, hustle or shot dashboard splits.

BALLDONTLIE Webhook Events

15 real-time BALLDONTLIE events your AI agent can subscribe to.

Webhooks for AI agents Read the BALLDONTLIE docs

15 Events

Game Started Processes events fired when an NBA game begins.
Game Ended Processes events fired when an NBA game reaches final.
Game Period Ended Processes events fired when a period or quarter ends.
Game Overtime Processes events fired when a game enters overtime.
Player Scored Processes events fired when a player scores.
Player Rebound Processes events fired when a player gets a rebound.
Player Assist Processes events fired when a player records an assist.
Player Steal Processes events fired when a player records a steal.
Player Block Processes events fired when a player records a block.
Player Foul Processes events fired when a player commits a foul.
Player Turnover Processes events fired when a player commits a turnover.
Injury Created Processes events fired when a player is added to the injury report.
Injury Updated Processes events fired when a player's injury details change.
Injury Cleared Processes events fired when a player is removed from the injury report.
Active Check Returns 200 OK for webhook deliveries that do not carry a recognised NBA event type.

Do More, Build Less

Connect AI to BALLDONTLIE and control what it can do, down to the field

Multiple Interfaces

Access integrations via API, AI SDKs, MCP & A2A.

BALLDONTLIE MCP server

Managed Authentication

Pre-built authentication UI.

Agent auth

Falcon Engine

Every BALLDONTLIE action runs on Falcon.

Agent Execution Engine

StackOne Defender

88.7% prompt injection detection.

Prompt injection defense

Start Free Book a Demo

"What impressed us most about StackOne is its ambition and clarity. They're creating infrastructure that modern software and the entire AI agent ecosystem can rely on. The depth of secure integrations, the pace of delivery, and the team's foresight into AI's future uniquely position StackOne to redefine this category."

Luna Schmid, Partner at GV

"We've been impressed by how quickly and deeply StackOne integrates with complex enterprise systems -- and now, with their focus on agent-to-agent interoperability, they're unlocking even more powerful use cases for customers. StackOne delivers all of the above in a universal layer -- without compromise."