# Padel API - Documentation

> First-ever API for professional padel data. Access the latest padel player stats, rankings, and more.

- [Getting Started](https://padelapi.org/docs/index.md): Discover how to access and use the Padel API for professional padel data. Learn about authentication, coverage, rate limits, and supported tournaments.
- [List Live Matches](https://padelapi.org/docs/api-reference/live/list-live-matches.md): Retrieve currently live padel matches with real-time scores. Returns matches active in the last 10 minutes.
- [List Matches](https://padelapi.org/docs/api-reference/match/list-matches.md): Endpoint to retrieve all matches with filters for date range, round, category, and court. Supports sorting and pagination.
- [Show Match](https://padelapi.org/docs/api-reference/match/show-match.md): Endpoint to retrieve details of a specific match including teams, scores, and result. Use related endpoints for stats or point-by-point data.
- [Show Match Stats](https://padelapi.org/docs/api-reference/match/show-match-stats.md): Endpoint to retrieve detailed statistics of a specific match, both as match totals and broken down set by set. Every stat is reported per team, as a rate (`"58%"`) or as a tally (`"9"`).
- [Show Match Point By Point](https://padelapi.org/docs/api-reference/match/show-match-point-by-point.md): Retrieve the full point-by-point reconstruction of a padel match: every set, every game and every point as it was played. It works for **live matches** (updated within seconds of each point) and for **finished matches** (the complete historical record), making it the building block for live score wi…
- [Show Match Head to Head](https://padelapi.org/docs/api-reference/match/show-match-head-to-head.md): Endpoint to retrieve head-to-head history for a specific match. Returns all previous matches played between the same teams or players.
- [Search Head to Head Matches](https://padelapi.org/docs/api-reference/match/search-head-to-head-matches.md): Endpoint to search head-to-head matches between specific players. Supports querying matches across teams or between individual players.
- [Simulate Match](https://padelapi.org/docs/api-reference/match/simulate-match.md): Endpoint to simulate a match between two teams or individual players. Returns win probabilities calculated from their [Elo ratings](https://padelapi.org/docs/guides/padel-elo-rating), either the current ones or the ones in force on `played_at`. The [padel match prediction model](https://padelapi.org…
- [List Pairs](https://padelapi.org/docs/api-reference/pair/list-pairs.md): Endpoint to retrieve pairs of professional padel players that have played at least one match together, ordered by the date of their most recent match together by default.
- [Show Pair](https://padelapi.org/docs/api-reference/pair/show-pair.md): Endpoint to retrieve detailed information about a specific pair including their combined stats, match history, and performance together.
- [List Pair Matches](https://padelapi.org/docs/api-reference/pair/list-pair-matches.md): Endpoint to retrieve all matches played together by a specific pair with optional filters for tournament, date range, and round.
- [Show Pair Stats](https://padelapi.org/docs/api-reference/pair/show-pair-stats.md): Retrieve detailed performance statistics for a pair: win rate, sets won, and match analysis.
- [List Players](https://padelapi.org/docs/api-reference/player/list-players.md): Endpoint to retrieve professional padel players with filtering options by name, nationality, category, birthplace, and playing side.
- [Show Player](https://padelapi.org/docs/api-reference/player/show-player.md): Endpoint to retrieve detailed information about a specific player including their ranking, points, nationality, side, and career statistics.
- [List Player Matches](https://padelapi.org/docs/api-reference/player/list-player-matches.md): Endpoint to retrieve all matches played by a specific player with optional filters for tournament, date range, and round.
- [List Player Rankings](https://padelapi.org/docs/api-reference/player/list-player-rankings.md): Retrieve every ranking published for a player — multiple types (`official`, `race`, `elo`) — as the current snapshot or as a historical series.
- [List Player Pairs](https://padelapi.org/docs/api-reference/player/list-player-pairs.md): Endpoint to retrieve all pairs a player has played with, derived from their match history.
- [Show Player Stats](https://padelapi.org/docs/api-reference/player/show-player-stats.md): Retrieve aggregated career and performance statistics for a professional padel player, computed in real time from every finished and retired match in the Padel API database. Use it to power player profiles, scouting tools, fantasy models and fan dashboards without crunching raw match data yourself.
- [List Rankings](https://padelapi.org/docs/api-reference/ranking/list-rankings.md): Retrieve the ranking list for a given week. Snapshots are weekly and indexed by ISO week. Without `date` returns the latest snapshot; with `date` returns the snapshot in effect at that day.
- [List Seasons](https://padelapi.org/docs/api-reference/season/list-seasons.md): Endpoint to retrieve all seasons and filter by year. Season availability depends on tournament coverage. See the [coverage documentation](https://padelapi.org/docs#tournaments-coverage) for the seasons and tournaments currently supported.
- [Show Season](https://padelapi.org/docs/api-reference/season/show-season.md): Endpoint to retrieve detailed information about a specific season including start and end dates, tournaments count, and status.
- [List Season Tournaments](https://padelapi.org/docs/api-reference/season/list-season-tournaments.md): Endpoint to retrieve all tournaments of a specific season. For a more detailed filtering of tournaments, use the "List Tournaments" endpoint.
- [List Tournaments](https://padelapi.org/docs/api-reference/tournament/list-tournaments.md): Endpoint to retrieve all tournaments and filter based on various parameters such as name, location, country, level, and date range.
- [Show Tournament](https://padelapi.org/docs/api-reference/tournament/show-tournament.md): Endpoint to retrieve detailed information about a specific tournament including dates, location, level, and related matches and videos.
- [List Tournament Editions](https://padelapi.org/docs/api-reference/tournament/list-tournament-editions.md): Endpoint to retrieve every edition of the same recurring event across seasons (e.g. Italy Major 2023, 2024, 2025...), including the requested tournament itself, ordered by start date. Editions are matched by tournament name, level and country, so the list is a best effort when an event changes its n…
- [List Tournament Matches](https://padelapi.org/docs/api-reference/tournament/list-tournament-matches.md): Endpoint to retrieve all matches from a specific tournament with optional filters for date, round, category, court name, and last update time. Results can be sorted by date, court, court order, round or update time.
- [List Tournament Videos](https://padelapi.org/docs/api-reference/tournament/list-tournament-videos.md): Endpoint to retrieve all available video content for a specific tournament including match highlights and full match recordings.
- [List Tournament News](https://padelapi.org/docs/api-reference/tournament/list-tournament-news.md): Endpoint to retrieve news articles related to a specific tournament. Filter by language to get localized news content.
- [List Webhooks](https://padelapi.org/docs/api-reference/webhook/list-webhooks.md): Endpoint to retrieve all webhook subscriptions registered by the authenticated user.
- [Create Webhook](https://padelapi.org/docs/api-reference/webhook/create-webhook.md): Register a new webhook subscription. This is the only response that returns the `secret` in full, so store it before moving on.
- [Show Webhook](https://padelapi.org/docs/api-reference/webhook/show-webhook.md): Endpoint to retrieve a specific webhook subscription owned by the authenticated user.
- [Delete Webhook](https://padelapi.org/docs/api-reference/webhook/delete-webhook.md): Permanently remove a webhook subscription. The webhook will stop receiving events immediately.
- [Update Webhook](https://padelapi.org/docs/api-reference/webhook/update-webhook.md): Update the URL or events of an existing webhook subscription. Only the provided fields are modified — the secret and other attributes are preserved. Sending an empty `events` array effectively pauses the webhook without deleting it.
- [Response Codes](https://padelapi.org/docs/error-codes.md): Complete reference for Padel API HTTP response codes. What every success, redirect and error code means, and how to handle 401, 402, 404, 422, 429, and 500 in your application.
- [Statuses](https://padelapi.org/docs/statuses.md): Reference for all possible status values for seasons, tournaments and matches in the Padel API.
- [WebSockets](https://padelapi.org/docs/websockets.md): Build real-time padel scoreboards and live trackers with the Padel API: REST polling, WebSocket subscriptions, and working examples.
- [Webhooks](https://padelapi.org/docs/webhooks.md): Receive instant push notifications from the Padel API when tournaments, matches, or players are created, updated, or deleted — with HMAC-signed payloads and automatic retries.
- [About the Padel Analyst](https://padelapi.org/docs/padel-analyst/index.md): Connect AI assistants like Claude, ChatGPT, and VS Code to professional padel data through the Padel API MCP Server
- [Acerca de Padel Analyst](https://padelapi.org/docs/padel-analyst/acerca-de.md): Conecta asistentes de IA como Claude, ChatGPT y VS Code a datos profesionales de pádel a través del servidor MCP de Padel API
- [Install in ChatGPT](https://padelapi.org/docs/padel-analyst/chatgpt-plugin.md): Install the Padel Analyst app in ChatGPT in three steps and ask about players, tournaments, matches and statistics in your own words. Works on ChatGPT's free plan.
- [Install in Claude](https://padelapi.org/docs/padel-analyst/claude.md): Install Padel Analyst in Claude.ai to query professional padel data directly in conversations. Step-by-step setup guide for Claude Pro and Team users.
- [Install in ChatGPT via MCP](https://padelapi.org/docs/padel-analyst/chatgpt.md): Install Padel Analyst in ChatGPT to query professional padel data in your conversations. Step-by-step guide using Developer mode for Plus and Pro users.
- [Install in Claude Code](https://padelapi.org/docs/padel-analyst/claude-code.md): Install Padel Analyst in Claude Code to query professional padel data from your terminal. One-command setup using the MCP HTTP transport.
- [Install in n8n](https://padelapi.org/docs/padel-analyst/n8n.md): Connect Padel Analyst to n8n workflows using the MCP Client Tool node. Give your AI Agent automations access to professional padel data.
- [Your First Padel API Call](https://padelapi.org/docs/guides/your-first-api-call.md): Learn how to make your first Padel API call in minutes. Step-by-step guide covering authentication, example requests, and response handling.
- [Data Synchronization](https://padelapi.org/docs/guides/data-synchronization.md): Learn how to keep your local data in sync with the Padel API, handling new tournaments, cancellations, redirects, and player identity changes.
- [Padel Statistics API](https://padelapi.org/docs/guides/padel-statistics.md): Access professional padel statistics through the Padel API: match stats (serve %, break points, streaks), player career stats, and pair performance data.
- [Match Schedule Estimates](https://padelapi.org/docs/guides/match-schedule-estimates.md): How the Padel API turns an order of play into estimated start times for padel matches: how they are calculated, and how accurate they are.
- [Padel Elo Rating](https://padelapi.org/docs/guides/padel-elo-rating.md): What an Elo rating is in padel, how the Padel API rates every professional player, how to read the numbers and how to get the Elo leaderboard and its weekly history.
- [Padel Match Prediction Model](https://padelapi.org/docs/guides/padel-match-prediction.md): How the Padel API predicts padel matches: Elo ratings, calibrated win probabilities and the simulate endpoint, validated against more than 7,500 professional matches.
- [Match Watchability Index](https://padelapi.org/docs/guides/match-watchability-index.md): How the Padel API rates every match from 0 to 100 before it is played, combining player level, expected closeness and the round at stake, so you can find the padel match worth watching on any given day.
- [Padel API vs Scraping](https://padelapi.org/docs/guides/vs-scraping.md): Padel API vs building your own scraper: one normalized, enriched dataset across FIP, Premier Padel and WPT, so you can spend your time building the product.
- [Padel Intelligence Alternative](https://padelapi.org/docs/guides/vs-padel-intelligence.md): Padel Intelligence alternative: cumulative stats, tournament history, and live scores via REST API. For developers and fans, no visual app required.
- [Best Padel Player of All Time](https://padelapi.org/docs/guides/best-padel-player.md): Who is the best padel player in history? We break down the question into the right criteria and show you how to explore the data yourself with Padel Analyst.
- [Datos de Pádel para tu TFG/TFM](https://padelapi.org/docs/guides/padel-data-tfg-tfm.md): Datos profesionales de pádel para tu TFG o TFM. Guía para usar Padel API como fuente de datos en proyectos de Data Science, Machine Learning e IA.
- [Use Cases & Showcase](https://padelapi.org/docs/guides/use-cases-showcase.md): Discover how developers and businesses use Padel API to build fantasy sports apps, live score widgets, analytics tools, and AI integrations
- [Padel Advertising](https://padelapi.org/docs/guides/padel-advertising.md): Show your padel product across our network of padel sites. Reach a 100% padel audience with a native ad, and turn your ad budget into an investment that grows with us.
- [Consulting Services](https://padelapi.org/docs/guides/consulting.md): Get expert technical consulting for your padel application. Architecture guidance, API integration strategy, and data analysis expertise.
- [Changelog](https://padelapi.org/docs/blog/changelog.md): Stay up-to-date with Padel API releases, new features, bug fixes, and important announcements. Track all changes from the latest to earliest updates.
- [What's new in Aug 2026](https://padelapi.org/docs/blog/20260814-whats-new-in-padel-api-aug-2026-top-matches-predictions-and-breaking-changes.md): The new watchability index that ranks every match before it is played, public Elo ratings with calibrated match predictions, and two breaking changes coming on 14 September 2026.
- [Building a Padel Prediction Model](https://padelapi.org/docs/blog/20260728-building-a-padel-prediction-model.md): Two models built independently on the Padel API, compared reliability curves, and the same soft band in both. A joint note by Padel API and DeuceLab.
- [What's new in Jun 2026](https://padelapi.org/docs/blog/20260601-whats-new-in-padel-api-jun-2026-webhooks-rankings-and-more.md): Official rankings and the RACE ranking in a single call, expanded FIP coverage down to lower-tier events, and real-time webhooks for tournaments, matches and players.
- [What's new in Feb 2026](https://padelapi.org/docs/blog/20260202-whats-new-in-padel-api-feb-2026-ai-integration-new-analyst-plan-and-more.md): Introducing Padel Analyst for AI assistants, the new 19€ Analyst plan, expanded FIP coverage, and 2026 season data. Query padel data with ChatGPT and Claude.
- [What's new in Oct 2025](https://padelapi.org/docs/blog/20251022-whats-new-in-padel-api-oct-2025-new-paid-plan-expanded-coverage-and-more.md): Discover the new 49€ Pro plan, our move to padelapi.org, the new Padel API Explorer, and FIP tournament coverage. More data, better tools, same reliable API.

## OpenAPI Specs

- [api](https://padelapi.org/docs/api.json)