> ## 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. # List Live Matches > Retrieve currently live padel matches with real-time scores. Returns matches active in the last 10 minutes. For instant push updates instead of polling, see the [WebSockets guide](https://padelapi.org/docs/websockets). > 🔒 This endpoint [requires a **Pro** subscription](https://padelapi.org/billing). ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /live openapi: 3.1.0 info: title: Padel API – API Reference version: '1.0' description: padelapi.org servers: - url: https://padelapi.org/api security: - http: [] paths: /live: get: tags: - Live summary: List Live Matches description: >- Retrieve currently live padel matches with real-time scores. Returns matches active in the last 10 minutes. For instant push updates instead of polling, see the [WebSockets guide](https://padelapi.org/docs/websockets). > 🔒 This endpoint [requires a **Pro** subscription](https://padelapi.org/billing). operationId: listLiveMatches responses: '200': description: Paginated set of `MatchLiveResource` content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/MatchLiveResource' links: type: object properties: first: type: - string - 'null' last: type: - string - 'null' prev: type: - string - 'null' next: type: - string - 'null' required: - first - last - prev - next meta: type: object properties: current_page: type: integer from: type: - integer - 'null' last_page: type: integer links: type: array description: Generated paginator links. items: type: object properties: url: type: - string - 'null' label: type: string active: type: boolean required: - url - label - active path: type: - string - 'null' description: Base path for paginator generated URLs. per_page: type: integer description: Number of items shown per page. to: type: - integer - 'null' description: Number of the last item in the slice. total: type: integer description: Total number of items being paginated. required: - current_page - from - last_page - links - path - per_page - to - total required: - data - links - meta '401': $ref: '#/components/responses/AuthenticationException' components: schemas: MatchLiveResource: type: object properties: id: type: integer description: >- Unique identifier of the match. The same id used by the rest of the match endpoints. self: type: string description: Path to this endpoint, relative to `https://padelapi.org`. draw: type: string description: >- Draw the match belongs to: `main` for the main draw, `qualy` for the qualification draw, and `group` or `placement` in team tournaments. This endpoint returns every draw, as it lists whatever is being played right now. enum: - main - qualy - group - placement status: type: string description: >- Current state of the match. See the [statuses reference](https://padelapi.org/docs/statuses#match-statuses) for the full list. enum: - scheduled - live - ended - finished - retired - walkover - bye - not_played coverage: description: >- 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. anyOf: - type: 'null' - type: string enum: - full - partial - tracking channel: type: string description: >- Name of the channel broadcasting updates for this match. It is issued per match and cannot be built from the match id, so always read it from this response. Subscribe to it to receive points as they happen instead of polling, as described in the [WebSockets guide](https://padelapi.org/docs/websockets). sets: type: array description: >- 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`. items: type: object properties: set_number: type: integer set_score: type: - string - 'null' games: type: array items: type: object properties: game_number: type: integer game_score: type: string serving: type: - string - 'null' points: type: array items: type: string required: - game_number - game_score - serving - points required: - set_number - set_score - games connections: type: object description: Related endpoints for this match. properties: match: type: string description: 'Full match details: teams, score, round and tournament.' required: - match required: - id - self - draw - status - coverage - channel - sets - connections title: MatchLiveResource responses: AuthenticationException: description: Unauthenticated content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message securitySchemes: http: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.