# Padel API - Documentation

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

## Docs

- [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.
- [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.
- [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 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.
- [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 Stats](https://padelapi.org/docs/api-reference/match/show-match-stats.md): Endpoint to retrieve detailed statistics of a specific match.
- [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 current Elo ratings.
- [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](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.
- [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 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 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.
- [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`) — as the current snapshot or as a historical series.
- [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.
- [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 FIP 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 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 Seasons](https://padelapi.org/docs/api-reference/season/list-seasons.md): Endpoint to retrieve all seasons and filter by year. Currently, only seasons from 2023 onwards are available.
- [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 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 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 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 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.
- [Create Webhook](https://padelapi.org/docs/api-reference/webhook/create-webhook.md): Register a new webhook subscription. The response includes a `secret` used to verify HMAC-signed payloads — store it securely, it will not be returned again.
- [Delete Webhook](https://padelapi.org/docs/api-reference/webhook/delete-webhook.md): Permanently remove a webhook subscription. The webhook will stop receiving events immediately.
- [List Webhooks](https://padelapi.org/docs/api-reference/webhook/list-webhooks.md): Endpoint to retrieve all webhook subscriptions registered by the authenticated user.
- [Show Webhook](https://padelapi.org/docs/api-reference/webhook/show-webhook.md): Endpoint to retrieve a specific webhook subscription owned by the authenticated user.
- [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.
- [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.
- [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 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.
- [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.
- [Error Codes](https://padelapi.org/docs/error-codes.md): Complete reference for Padel API HTTP status codes and error responses. Learn how to handle 401, 402, 404, 422, 429, and 500 errors in your application.
- [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.
- [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.
- [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.
- [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.
- [Padel Fan Index](https://padelapi.org/docs/guides/padel-fan-index.md): Sponsor-grade analytics that measure real fan engagement with professional padel players. Powered by Fantasy Padel Tour and Padel API.
- [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.
- [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 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.
- [Padel API vs Scraping](https://padelapi.org/docs/guides/vs-scraping.md): Padel API vs building your own scraper: normalization, WebSockets, canonical IDs, and unified coverage across FIP, Premier Padel, and WPT.
- [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.
- [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.
- [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.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](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 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.
- [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
- [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.
- [Statuses](https://padelapi.org/docs/statuses.md): Reference for all possible status values for seasons, tournaments and matches in the Padel API.
- [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.
- [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.

## OpenAPI Specs

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