Show Match Point By Point
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 widgets, win-probability models, momentum charts and match replays.
π This endpoint requires a Pro subscription.
Live updates: poll or subscribe
You can poll this endpoint, but for real-time apps subscribe to push updates instead.
Every response includes a channel (e.g. matches.123) and a connections.match
link; broadcast events arrive over Pusher. See the
WebSockets guide for the subscription flow.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The match ID
Response
MatchLiveResource
Unique identifier of the match. The same id used by the rest of the match endpoints.
Path to this endpoint, relative to https://padelapi.org.
Current state of the match. See the statuses reference for the full list.
scheduled, live, ended, finished, retired, walkover, bye How complete the point-by-point tracking is. full means every game was captured and matches the confirmed score. partial means some games are missing because the feed had gaps. tracking means the match is still live and coverage is resolved once it ends. null means there is no point-by-point data. Use full for statistical analysis: it guarantees game-level completeness, though individual points within a game may occasionally be missing.
full, partial, tracking Name of the channel broadcasting updates for this match (e.g. matches.123). Subscribe to it to receive points as they happen instead of polling, as described in the WebSockets guide.
The match broken down into sets β games β points, in the order they were played. Each set carries a set_number and a set_score (e.g. "6-3", or null while the set is still in progress). Each game carries a game_number, the cumulative game_score at the start of the game (e.g. "3-2"), the serving team ("team_1", "team_2", or null when unknown) and the ordered list of points as "team_1:team_2" strings (["0:0", "15:0", "15:15", β¦], with "A" for advantage).
The point that wins a game is never listed: the score jumps to the next game, so derive it from the following game_score.
Related endpoints for this match.