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

> Endpoint to retrieve details of a specific match including teams, scores, and result. Use related endpoints for stats or point-by-point data.

See [Match Statuses](https://padelapi.org/docs/statuses#match-statuses) for the meaning of the `status` field.



## OpenAPI

````yaml https://padelapi.org/docs/api.json get /matches/{match}
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}:
    get:
      tags:
        - Match
      summary: Show Match
      description: >-
        Endpoint to retrieve details of a specific match including teams,
        scores, and result. Use related endpoints for stats or point-by-point
        data.


        See [Match Statuses](https://padelapi.org/docs/statuses#match-statuses)
        for the meaning of the `status` field.
      operationId: getMatch
      parameters:
        - name: match
          in: path
          required: true
          description: The match ID
          schema:
            type: integer
      responses:
        '200':
          description: '`MatchResource`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MatchResource'
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '404':
          $ref: '#/components/responses/ModelNotFoundException'
components:
  schemas:
    MatchResource:
      type: object
      properties:
        id:
          type: integer
        self:
          type: string
        name:
          type: string
        url:
          type:
            - string
            - 'null'
        category:
          type: string
        tournament:
          $ref: '#/components/schemas/TournamentResource'
        round:
          type: integer
        round_name:
          type: string
        index:
          type: integer
        seeds:
          type: string
          description: >-
            Each team's draw marker as a string: seed number (e.g. `"1"`), or
            entry code (`"WC"`/`"Q"`/`"LL"`/`"ALT"`) for unseeded special
            entries; `null` when entered by ranking unseeded. Always a `{team_1,
            team_2}` object.
        played_at:
          type:
            - string
            - 'null'
        schedule_label:
          type: string
        scheduled_at:
          type:
            - string
            - 'null'
          description: >-
            Scheduled start in server timezone (`Europe/Madrid`). Resolved from
            `schedule_label`; null for "followed by" matches with no announced
            time.
        scheduled_at_local:
          type:
            - string
            - 'null'
          description: >-
            Same instant as `scheduled_at`, serialized in the tournament's
            timezone.
        court:
          type: string
        court_order:
          type:
            - integer
            - 'null'
        status:
          type: string
          enum:
            - scheduled
            - live
            - ended
            - finished
            - retired
            - walkover
            - bye
        score:
          description: >-
            Final score of the match. On the free plan, matches played more than
            6 months ago return `hidden_free_plan`; paid plans include the full
            historical archive.
          anyOf:
            - type: string
            - type: string
              enum:
                - hidden_free_plan
        winner:
          description: >-
            Winning team (`team_1` or `team_2`). On the free plan, matches
            played more than 6 months ago return `hidden_free_plan`; paid plans
            include the full historical archive.
          anyOf:
            - type: string
            - type: string
              enum:
                - hidden_free_plan
        started_time:
          type:
            - string
            - 'null'
          description: >-
            Actual start of play (first tracked point, after warm-up), in server
            timezone (`Europe/Madrid`). Distinct from `scheduled_at`, which is
            the announced start time.
        started_time_local:
          type:
            - string
            - 'null'
          description: >-
            Same instant as `started_time`, serialized in the tournament's
            timezone.
        duration:
          type: string
        players:
          type: object
          properties:
            team_1:
              $ref: '#/components/schemas/MatchPairResource'
            team_2:
              $ref: '#/components/schemas/MatchPairResource'
          required:
            - team_1
            - team_2
        updated_at:
          type: string
        connections:
          type: string
      required:
        - id
        - self
        - name
        - url
        - category
        - round
        - round_name
        - index
        - seeds
        - played_at
        - schedule_label
        - scheduled_at
        - scheduled_at_local
        - court
        - court_order
        - status
        - score
        - winner
        - started_time
        - started_time_local
        - duration
        - players
        - updated_at
        - connections
      title: MatchResource
    TournamentResource:
      type: object
      properties:
        id:
          type: integer
        self:
          type: string
        name:
          type: string
        url:
          type:
            - string
            - 'null'
        location:
          type: string
        venue:
          type:
            - object
            - 'null'
          properties:
            name:
              type:
                - string
                - 'null'
            address:
              type:
                - string
                - 'null'
          required:
            - name
            - address
        country:
          type: string
        timezone:
          type: string
        level:
          type: string
        status:
          type: string
        court_type:
          anyOf:
            - type: 'null'
            - type: string
              enum:
                - indoor
                - outdoor
                - covered
        prize:
          type:
            - object
            - 'null'
          properties:
            amount:
              type: integer
            currency:
              type: string
          required:
            - amount
            - currency
        start_date:
          type: string
        end_date:
          type: string
        winners:
          type:
            - object
            - 'null'
          additionalProperties:
            $ref: '#/components/schemas/MatchPairResource'
        links:
          type: string
        updated_at:
          type: string
        connections:
          type: string
      required:
        - id
        - self
        - name
        - url
        - location
        - venue
        - country
        - timezone
        - level
        - status
        - court_type
        - prize
        - start_date
        - end_date
        - winners
        - links
        - updated_at
        - connections
      title: TournamentResource
    MatchPairResource:
      type: array
      prefixItems:
        - type: object
          properties:
            id:
              type: integer
            self:
              type: string
            name:
              type: string
            side:
              anyOf:
                - type: 'null'
                - type: string
                  enum:
                    - drive
                    - backhand
            connections:
              type: string
          required:
            - id
            - self
            - name
            - side
            - connections
      minItems: 1
      maxItems: 1
      additionalItems: false
      title: MatchPairResource
  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
  securitySchemes:
    http:
      type: http
      scheme: bearer

````