Changelog - Padel API - Documentation

Rivals, Agent Authentication & New Filters

New: Player and pair rivals: /players/{id}/rivals and /pairs/{player1}-{player2}/rivals return the opponents they have faced most, with the record, finals and titles against each, across their whole history and with the same filters as the stats endpoints (Pro plan). Details in the October newsletter
New: Agent authentication: an AI agent can now obtain an API token through the same OAuth flow as the MCP server, and the padelapi.org home has a button to copy the agent setup prompt
New: id filter on the matches, players, tournaments, seasons and pairs endpoints, accepting up to 100 ids per request
New: level filter on the head-to-head endpoints and on player and pair matches
New: nationality and short_name on the players of a match, so flags and surnames can be shown without fetching each player
New: order_by on tournament editions to reverse the date order
New: created_at and updated_at on seasons, with updated_after and updated_before filters
after_date and before_date now return every tournament with at least one day inside the range and only pairs with matches inside it, and before_date can equal after_date to query a single day
Pair stats, synergy and rivals return 404 only when the two players have never played together; otherwise they return empty data
MCP: Padel Analyst is now listed in the official MCP Registry
Docs: Added the Padel Head to Head, Padel Betting Data and Agent Authentication guides
Docs: Added the Claude directory installation guide for Padel Analyst

Team Tournaments, Player Form & Elo Leaderboard

New: Team tournaments, ready for the FIP World Cup: format field and filter on tournaments, a tie object on their matches, group and placement draws, the not_played match status and new webhook events. Details in the September newsletter
New: Player form and pair synergy: /players/{id}/form and /pairs/{player1}-{player2}/synergy compare actual results against what the Elo ratings predicted, with the gap by period and its trend (Business plan)
New: Elo leaderboard: type=elo on the rankings endpoint, published as a weekly snapshot, with the full rating history on the player rankings endpoint
New: photo_url field on tournaments with the event poster
New: postponed tournament status
Now in effect: Simulate Match and both head-to-head endpoints require Pro, and duration, started_time and started_time_local are hidden on Free
Breaking: WebSocket channel names are now issued per match by the live endpoints and can no longer be built from the match id
ranking_diff and points_diff are now measured against the player’s previous published edition, so a player returning after a long absence re-enters with no movement
Schedule estimates now pick up start times announced in 24-hour format
Terms updated with a Third-Party Images section and a licence that covers every plan
MCP: Free plan tool calls are now capped per day, with an upgrade option on the authorization screen

Watchability Index, Qualification Draws & Past-Date Simulations

Coming 14 September: Simulate Match and both head-to-head endpoints move to Pro, and duration, started_time and started_time_local are hidden on Free. Details in the August newsletter
New: watchability field on matches: a 0-100 score of how good a match promises to be, set as soon as both pairs are known, with sorting by it on the matches endpoint (paid plans)
New: Qualification draws: draw field on matches (main or qualy), plus draw=qualy and draw=all filters on listings and on the live feed (paid plans)
New: match.qualy.* webhook events for qualification matches
New: tournament.backfilled and match.backfilled webhook events for tournaments added to the calendar after they were played
New: played_at on Simulate Match, to replay a match-up with the Elo ratings in force on that day
New: after_date and before_date filters on the head-to-head endpoints
New: 302 redirects on removed and merged matches, resolving to the canonical match
Terms updated to state explicitly that commercial use of the API is permitted
Fixed pagination links dropping the parameters of the original query
Fixed a 500 when sort_by or order_by were sent empty
MCP: draw filter, watchability sorting and head-to-head date filters on the match tools
Docs: Added the Match Watchability Index guide
Docs: Added the ChatGPT app installation guide
Docs: Renamed Error Codes to Response Codes, correcting 402 and telling the per-minute and per-day rate limits apart
Docs: Added qualification draw coverage to the tournament level tables and clarified that player and pair stats cover the main draw only
Docs: Added StudyPadel, La Chiquita Pádel and an Other Directories section to the use cases showcase

Elo Ratings, Match Predictions & Schedule Estimates

New: Tournament editions endpoint 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 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, Padel Match Prediction Model and Match Schedule Estimates guides
Docs: Published 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

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 and n8n integration guides
Docs: Rewrote Padel Analyst landing and updated MCP tools list (16 tools)
Docs: Added Padel Advertising guide
Docs: Added DeuceLab and Padel Earnings to the use cases showcase

Webhooks, Rankings & Career Stats

New: Webhooks for tournament, match and player events (Business plan)
New: Bulk rankings endpoint with official and RACE types
New: Ranking history endpoint 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 reference page
Docs: Interlinking between guides, reference and API endpoints

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 guide
Docs: Updated WebSockets reference
Docs: Redesigned showcase page with Live Scores category
Docs: Separated endpoints and reference groups in navigation

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 page
Docs: Added WebSockets guide
Docs: Added Data Synchronization guide

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 and 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

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 workflows
Added cancelled status support for matches
Docs: Added Padel Analyst section with Claude.ai and ChatGPT integration guides
Docs: Added error codes reference page
Docs: Added getting started guide
Docs: Added rate limits documentation

Looking for earlier releases? See the 2025 changelog.