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

# Changelog

> Stay up-to-date with Padel API releases, new features, bug fixes, and important announcements. Track all changes from the latest to earliest updates.

<Update label="July 2026" description="Elo Ratings, Match Predictions & Schedule Estimates">
  * **New:** [Tournament editions endpoint](/docs/api-reference/tournament/list-tournament-editions) linking editions of the same event across seasons
  * **New:** `elo` field on players — Elo ratings are now public, with `elo` sorting on the players endpoint and MCP tool
  * **New:** `favorite` and `elo_diff` fields on [Simulate Match](/docs/api-reference/match/simulate-match) responses
  * **New:** Estimated `schedule_label` on matches without an announced start time
  * Simulate probabilities are now calibrated, validated against 7,500+ professional matches
  * Head-to-head endpoint now only includes played matches
  * Improved live point-by-point: reconstruction of unambiguous missing points and normalized deuce sequences
  * Improved draw updates: withdrawals, byes and re-published draws are now reflected on re-import
  * Fixed duplicate court order values in the order of play
  * **MCP:** Pagination via `per_page` on listing tools, richer tool and parameter descriptions, and validation errors returned as tool results
  * Padel Analyst chat embedded on Fantasy Padel Tour player, tournament and match pages
  * **Docs:** Added [Padel Elo Rating](/docs/guides/padel-elo-rating), [Padel Match Prediction Model](/docs/guides/padel-match-prediction) and [Match Schedule Estimates](/docs/guides/match-schedule-estimates) guides
  * **Docs:** Published [Building a Padel Prediction Model](/docs/blog/20260728-building-a-padel-prediction-model), a joint note with DeuceLab
  * **Docs:** Clarified that `full` coverage means game-level completeness
  * **Docs:** Redocumented all API resource properties
</Update>

<Update label="June 2026" description="Venue & Prize Data, Seeds and Plus Plan">
  * **New:** `venue`, `court_type` and `prize` fields on tournaments
  * **New:** Team seeds exposed on matches (seed number or entry code)
  * **New:** `started_time_local` and `scheduled_at` fields on matches
  * **New:** `status` (`current`/`former`) on pairs listing, plus MCP tool for searching pairs
  * **New:** Filters and sorting on rankings and tournament matches endpoints
  * **New:** Historical Padel Pro Tour coverage, extending historical depth
  * **New:** OAuth loopback redirect URIs with arbitrary ports for local integrations
  * Analyst plan renamed to **Plus**
  * Rankings on Free plan: only the current snapshot is visible, flagged via `hidden_free_plan`
  * News engine migrated to Google News for fresher, more complete coverage
  * Fixed webhook delivery failures on tournament status transitions
  * Fixed phantom point in the last game of live point-by-point
  * **Docs:** Added [Claude Code](/docs/padel-analyst/claude-code) and [n8n](/docs/padel-analyst/n8n) integration guides
  * **Docs:** Rewrote [Padel Analyst](/docs/padel-analyst) landing and updated MCP tools list (16 tools)
  * **Docs:** Added [Padel Advertising](/docs/guides/padel-advertising) guide
  * **Docs:** Added DeuceLab and Padel Earnings to the [use cases showcase](/docs/guides/use-cases-showcase)
</Update>

<Update label="May 2026" description="Webhooks, Rankings & Career Stats">
  * **New:** Webhooks for tournament, match and player events (Business plan)
  * **New:** [Bulk rankings endpoint](/docs/api-reference/ranking/list-rankings) with official and RACE types
  * **New:** [Ranking history endpoint](/docs/api-reference/player/list-player-rankings) for player rankings over time
  * **New:** MCP tool for player rankings
  * **New:** `timezone` field on tournaments, resolved via GeoNames
  * Filter player and pair stats by tournament level
  * Include `retired` matches in player/pair stats to match FIP
  * Accelerated `ended` → `finished` transition
  * Fixed ELO calculation: real winner, individual diff, idempotency and margin modulation
  * Fixed `sort_by`/`order_by` on player and pair matches endpoints
  * **Docs:** Added [Webhooks](/docs/webhooks) reference page
  * **Docs:** Interlinking between guides, reference and API endpoints
</Update>

<Update label="April 2026" description="Player Pairs, FIP Silver & updated_at Filter">
  * **New:** Player pairs endpoint (`/players/{id}/pairs`)
  * **New:** `updated_at` parameter for incremental syncs on list endpoints
  * **New:** FIP Silver added to tournament level coverage
  * **New:** `serving` field in live match response
  * **New:** `redirect_to` for merged players (resolves to canonical player)
  * Show cancelled tournaments and all statuses in Season relations
  * Applied Business plan rate limits as documented
  * Improved match-info update cadence and tournament filtering
  * Fixed duplicate players (Daniel Aguero, Letizia Dellagnese)
  * **Docs:** Added [Padel API vs Scraping](/docs/guides/vs-scraping) guide
  * **Docs:** Updated [WebSockets](/docs/websockets) reference
  * **Docs:** Redesigned showcase page with Live Scores category
  * **Docs:** Separated endpoints and reference groups in navigation
</Update>

<Update label="March 2026" description="Match Statuses, Live Fixes & WebSockets">
  * **New:** Match status `ended` for matches pending official score
  * **New:** `short_name` property in Player resource
  * Added `ended` and `finished` events to WebSocket `MatchLiveUpdated`
  * Cancelled tournaments hidden from list endpoints
  * Fixed duplicate and flickering points in live point-by-point
  * Updated rate limits: Free 2,000 req/day, Pro 4,000 req/day
  * **Docs:** Added [Statuses reference](/docs/statuses) page
  * **Docs:** Added [WebSockets](/docs/websockets) guide
  * **Docs:** Added [Data Synchronization](/docs/guides/data-synchronization) guide
</Update>

<Update label="February 2026" description="LLMs, OAuth & Match Simulator">
  * **New:** `llms.txt` endpoint for AI and LLM agent discovery
  * **New:** MCP tool `show-match-live` for point-by-point live scores
  * **New:** OAuth refresh token for [ChatGPT](/docs/padel-analyst/chatgpt) and [Claude](/docs/padel-analyst/claude) integration
  * Refactored match simulator to use player ELO averages
  * Updated API rate limiting and subscription checks
  * Improved player name and surname formatting
  * Fixed duplicate player entries
  * Fixed tournament videos endpoint error
</Update>

<Update label="January 2026" description="Padel Analyst & Live Improvements">
  * Fixed timezone bug in live match point-by-point data retrieval
  * Improved error handling for live endpoint
  * Added MCP prompts for common [Padel Analyst](/docs/padel-analyst) workflows
  * Added `cancelled` status support for matches
  * **Docs:** Added [Padel Analyst](/docs/padel-analyst) section with [Claude.ai](/docs/padel-analyst/claude) and [ChatGPT](/docs/padel-analyst/chatgpt) integration guides
  * **Docs:** Added [error codes](/docs/error-codes) reference page
  * **Docs:** Added [getting started](/docs/guides/your-first-api-call) guide
  * **Docs:** Added rate limits documentation
</Update>

<Update label="December 2025" description="2026 Season Preparation">
  * Prepared API for 2026 Premier Padel season
  * Added `per_page` parameter to list endpoints
  * Added new [MCP tool](/docs/padel-analyst) parameters
  * Filtered private tournaments from public responses
</Update>

<Update label="November 2025" description="Pairs & Statistics Endpoints">
  * **New:** Pairs endpoint (`/pairs`) with full pair information
  * **New:** Pair statistics endpoint with match history
  * **New:** Player statistics resource (`/players/{id}/stats`)
  * Added date filters for matches endpoint
  * Added filters to pair endpoints (matches, statistics)
  * Added FIP Gold and FIP Silver tournament levels
  * Added Fantasy integration to Season API
  * Improved [error responses](/docs/error-codes): 422 for unsupported tournament levels
</Update>

<Update label="October 2025" description="CSV Export & Match Enhancements">
  * **New:** CSV export feature (PRO plan)
  * **New:** Match head-to-head endpoint (`/matches/{id}/h2h`)
  * **New:** Previous and next match relations
  * **New:** Match video relation
  * Added `language` parameter to news endpoint
  * Added `round_name` field to match response
  * Added `court` parameter to matches list
  * Added player and tournament links/URLs
  * Improved tournament error handling
  * Renamed court order fields for consistency
</Update>

<Update label="September 2025" description="Match Status & Videos">
  * **New:** Tournament videos endpoint
  * Added `retired` status for incomplete matches
  * Improved match duration calculation
</Update>

<Update label="August 2025" description="Player Search Improvements">
  * Fixed point-by-point live scores
  * Added additional player search parameters
  * Added more sorting options for players endpoint
</Update>

<Update label="July 2025" description="Live Scores Enhancement">
  * Added `winner` attribute to match response
  * Added `channel` information to live resource
  * Improved score format to include tie-break details
</Update>

<Update label="June 2025" description="Match Simulator & Elo History">
  * **New:** Match simulator endpoint (`POST /matches/simulate`)
  * **New:** Elo history endpoint for players
  * **New:** Match category filter
  * Added match index to API response
  * Updated [MCP integration](/docs/padel-analyst) to version 1.1
  * Added configurable tournament level support
</Update>

<Update label="May 2025" description="MCP Tools & Related Matches">
  * **New:** Related matches endpoint (`/matches/{id}/related`)
  * **New:** Head-to-head (H2H) endpoint
  * **New:** [MCP tools](/docs/padel-analyst) for Claude Desktop integration
  * Added player search by name with unaccent support
  * Added tournament search by name
  * Added match sorting and ordering parameters
  * Added `page` parameter to player matches
  * Moved players data to subproperty in match response
</Update>

<Update label="April 2025" description="Live Scores Launch">
  * **New:** Live scores endpoint (`/live`)
  * **New:** Point-by-point match details
  * Real-time match data with 4-second cache
  * API request logging infrastructure
</Update>

<Update label="March 2025" description="Match Statistics">
  * **New:** Match statistics resource (`/matches/{id}/stats`)
  * Added statistics translations
  * Added match name field
  * Improved tournament name formatting
  * Limited seasons to Premier Padel coverage
</Update>