> ## 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. # Show Match Stats > Endpoint to retrieve detailed statistics of a specific match, both as match totals and broken down set by set. Every stat is reported per team, as a rate (`"58%"`) or as a tally (`"9"`). > 🔒 This endpoint [requires a **Pro** subscription](https://padelapi.org/billing). ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /matches/{match}/stats 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: /matches/{match}/stats: get: tags: - Match summary: Show Match Stats description: >- Endpoint to retrieve detailed statistics of a specific match, both as match totals and broken down set by set. Every stat is reported per team, as a rate (`"58%"`) or as a tally (`"9"`). > 🔒 This endpoint [requires a **Pro** subscription](https://padelapi.org/billing). operationId: getMatchStats parameters: - name: match in: path required: true description: The match ID schema: type: integer responses: '200': description: '`MatchStatsResource`' content: application/json: schema: $ref: '#/components/schemas/MatchStatsResource' '401': $ref: '#/components/responses/AuthenticationException' '404': $ref: '#/components/responses/ModelNotFoundException' '422': $ref: '#/components/responses/ValidationException' components: schemas: MatchStatsResource: type: object properties: id: type: integer description: Unique identifier of the match these stats belong to. self: type: string description: Path to this endpoint, relative to `https://padelapi.org`. match: description: >- Totals for the whole match, across every set played. Absent when the match has no statistics. anyOf: - type: array items: type: string minItems: 0 maxItems: 0 additionalItems: false - $ref: '#/components/schemas/MatchStatsBlockResource' set_1: description: The same stats restricted to the first set. anyOf: - type: array items: type: string minItems: 0 maxItems: 0 additionalItems: false - $ref: '#/components/schemas/MatchStatsBlockResource' set_2: description: >- The same stats restricted to the second set. Comes back as an empty array when the set was played but no statistics were reported for it. anyOf: - type: array items: type: string minItems: 0 maxItems: 0 additionalItems: false - $ref: '#/components/schemas/MatchStatsBlockResource' set_3: description: >- The same stats restricted to the third set. Absent when the match was decided in two, and an empty array when the set was played but no statistics were reported for it. anyOf: - type: array items: type: string minItems: 0 maxItems: 0 additionalItems: false - $ref: '#/components/schemas/MatchStatsBlockResource' connections: type: object description: Related endpoints for these stats. properties: match: type: string description: 'Full match details: teams, score, round and tournament.' required: - match required: - id - self - connections title: MatchStatsResource MatchStatsBlockResource: type: object properties: total_points_won: type: object description: Share of all points won by each team. The two values add up to 100%. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 break_points_converted: type: object description: >- Share of break points the team converted out of those it played. `"0%"` means break points came up and none were taken, which is different from never having had one. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 longest_streak: type: object description: Longest run of consecutive points won. A tally, not a rate. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 aces: type: object description: >- Serves won outright, without the returning team putting a racket on the ball. A tally, not a rate. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 double_faults: type: object description: >- Serves that missed twice in a row, handing the point away. A tally, not a rate. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 won_on_1st_serve: type: object description: Share of points won when the team's first serve landed in. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 won_on_2nd_serve: type: object description: >- Share of points won when the team missed the first serve and had to play a second. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 service_games: type: object description: Number of games the team served. A tally, not a rate. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 won_on_1st_return: type: object description: Share of points won when returning the opponent's first serve. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 won_on_2nd_return: type: object description: Share of points won when returning the opponent's second serve. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 return_games: type: object description: >- Number of games the team received. Mirrors the opponent's `service_games`. A tally, not a rate. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 total_won_on_serve: type: object description: >- Share of all points won on the team's own serve, first and second combined. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 total_won_on_return: type: object description: Share of all points won while returning, first and second combined. properties: team_1: type: string team_2: type: string required: - team_1 - team_2 required: - total_points_won - break_points_converted - longest_streak - aces - double_faults - won_on_1st_serve - won_on_2nd_serve - service_games - won_on_1st_return - won_on_2nd_return - return_games - total_won_on_serve - total_won_on_return title: MatchStatsBlockResource responses: AuthenticationException: description: Unauthenticated content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message ModelNotFoundException: description: Not found content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message ValidationException: description: Validation error content: application/json: schema: type: object properties: message: type: string description: Errors overview. errors: type: object description: A detailed description of each field that failed validation. additionalProperties: type: array items: type: string required: - message - errors securitySchemes: http: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.