# 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): Endpoint to retrieve currently live matches with real-time scores. Returns matches active within 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): Endpoint to retrieve point-by-point details of a specific match.
- [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): Endpoint to retrieve detailed performance statistics for a specific pair including 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 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): Endpoint to retrieve detailed performance statistics for a specific player including win rate, sets, and match history analysis.
- [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, and court name.
- [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.
- [Show Video](https://padelapi.org/docs/api-reference/video/show-video.md): Endpoint to retrieve detailed information about a specific tournament video including title, duration, thumbnail, and streaming URL.
- [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.
- [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): Guía en español para estudiantes universitarios que buscan datos deportivos para su Trabajo Final de Grado o Máster. Aprende a usar Padel API como fuente de datos para proyectos de Data Science, Machine Learning e Inteligencia Artificial.
- [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): Three levels of statistics to analyze professional padel: match-level, player career, and pair performance.
- [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): How Padel API compares to Padel Intelligence: cumulative stats and full tournament history via API vs. manual shot-level analysis with limited coverage.
- [Padel API vs Scraping](https://padelapi.org/docs/guides/vs-scraping.md): A technical comparison: what you get from a maintained padel data API versus building and operating your own scraper 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.
- [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
- [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 using the Padel API. Step-by-step guide covering REST polling, WebSocket subscriptions, and full working examples.

## OpenAPI Specs

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