Show Match Point By Point

curl --request GET \
  --url https://padelapi.org/api/matches/{match}/live \
  --header 'Authorization: Bearer <token>'

{
  "id": 123,
  "self": "<string>",
  "status": "<string>",
  "coverage": "<string>",
  "channel": "<string>",
  "sets": [
    {
      "set_number": 123,
      "set_score": "<string>",
      "games": [
        {
          "game_number": 123,
          "game_score": "<string>",
          "serving": "<string>",
          "points": [
            "<string>"
          ]
        }
      ]
    }
  ],
  "connections": {
    "match": "<string>"
  }
}

Match

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.

Response shape

The match breaks down into nested sets → games → points:

Each set has a set_number and a set_score (e.g. "6-3", or null while the set is still in progress).
Each game has 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 (["0:0", "15:0", "15:15", …]).

Status and coverage

status — live, finished, retired, walkover, bye or scheduled.
coverage — how complete the tracking is: full (every game captured), partial (the source feed had gaps), tracking (still live, resolved once finished) or null (no point-by-point data available).

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.

Related endpoints

Show Match — teams, score, round and tournament.
Show Match Stats — aggregated match statistics.
List Live Matches — every match currently in progress.

GET

matches

{match}

live

Show Match Point By Point

curl --request GET \
  --url https://padelapi.org/api/matches/{match}/live \
  --header 'Authorization: Bearer <token>'

{
  "id": 123,
  "self": "<string>",
  "status": "<string>",
  "coverage": "<string>",
  "channel": "<string>",
  "sets": [
    {
      "set_number": 123,
      "set_score": "<string>",
      "games": [
        {
          "game_number": 123,
          "game_score": "<string>",
          "serving": "<string>",
          "points": [
            "<string>"
          ]
        }
      ]
    }
  ],
  "connections": {
    "match": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

match

integer

required

The match ID

Response

integer

required

self

string

required

status

string

required

coverage

string

required

channel

string

required

sets

object[]

required

Show child attributes

connections

object

required

Show child attributes

Show Match Stats Show Match Head to Head

Documentation Index

Authorizations

Path Parameters

Response