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

> Endpoint to retrieve all pairs a player has played with, derived from their match history.



## OpenAPI

````yaml https://padelapi.org/docs/api.json get /players/{player}/pairs
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:
  /players/{player}/pairs:
    get:
      tags:
        - Player
      summary: List Player Pairs
      description: >-
        Endpoint to retrieve all pairs a player has played with, derived from
        their match history.
      operationId: listPlayerPairs
      parameters:
        - name: player
          in: path
          required: true
          description: The player ID
          schema:
            type: integer
        - name: page
          in: query
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PairResource'
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '404':
          $ref: '#/components/responses/ModelNotFoundException'
components:
  schemas:
    PairResource:
      type: object
      properties:
        id:
          type: string
        self:
          type: string
        name:
          type: string
        category:
          type: string
        status:
          type: string
        points:
          type:
            - integer
            - 'null'
        first_match_at:
          type: string
        last_match_at:
          type: string
        players:
          type: array
          items:
            $ref: '#/components/schemas/PlayerResource'
        connections:
          type: string
      required:
        - id
        - self
        - name
        - category
        - status
        - points
        - first_match_at
        - last_match_at
        - players
        - connections
      title: PairResource
    PlayerResource:
      type: object
      properties:
        id:
          type: integer
          description: >-
            Unique identifier of the player. Stable across seasons, use it to
            reference the player from your own data.
        self:
          type: string
          description: Path to this player's endpoint, relative to `https://padelapi.org`.
        name:
          type: string
          description: Full name of the player, without accents or special characters.
        short_name:
          type: string
          description: Short display name, usually the surname.
        url:
          type:
            - string
            - 'null'
          description: Public player profile. `null` when the player has no profile page.
        photo_url:
          type:
            - string
            - 'null'
          description: Public URL of the player's photo. `null` when no photo is available.
        category:
          type: string
          description: >-
            Competition category the player competes in. Players never appear in
            both.
          enum:
            - men
            - women
        nationality:
          type: string
          description: >-
            ISO 3166-1 alpha-2 country code, uppercase. Reflects the country the
            player represents, which can differ from `birthplace`.
        ranking:
          type: string
          description: >-
            Current position in the official ranking. `null` for unranked
            players.
        points:
          type: integer
          description: >-
            Points backing the official ranking position. `null` for unranked
            players. Use [`GET
            /players/{player}/rankings`](https://padelapi.org/docs/api-reference/player/list-player-rankings)
            for the historical series.
        elo:
          type:
            - integer
            - 'null'
          description: >-
            Strength rating relative to the rest of the field, updated after
            every completed match. Every player enters the system at `1000`. See
            the [Elo rating
            guide](https://padelapi.org/docs/guides/padel-elo-rating) for how it
            is calculated and how to read it.
        height:
          type:
            - integer
            - 'null'
          description: Height in centimetres. `null` when not available.
        side:
          description: >-
            Side of the court the player covers. `drive` is the forehand side,
            `backhand` the other one. `null` when the player has no established
            side.
          anyOf:
            - type: 'null'
            - type: string
              enum:
                - drive
                - backhand
        hand:
          description: Dominant hand. `null` when not available.
          anyOf:
            - type: 'null'
            - type: string
              enum:
                - left
                - right
        birthplace:
          type:
            - string
            - 'null'
          description: City or region the player was born in. `null` when not available.
        birthdate:
          type:
            - string
            - 'null'
          description: Date of birth, as `YYYY-MM-DD`. `null` when not available.
        age:
          type:
            - string
            - 'null'
          description: >-
            Age in years derived from `birthdate`. `null` when the birthdate is
            not available.
        links:
          type: string
          description: >-
            External profile URLs for the player. `null` when none are
            available.
        updated_at:
          type: string
          description: >-
            ISO 8601 timestamp of the last change to any field of this player,
            including ranking and Elo. Use it to skip records you have already
            processed.
        connections:
          type: object
          description: Related endpoints for this player.
          properties:
            matches:
              type: string
              description: Matches played by this player.
            rankings:
              type: string
              description: Historical ranking positions and points for this player.
            pairs:
              type: string
              description: Partners this player has played with.
            stats:
              type: string
              description: Aggregated career and season statistics for this player.
          required:
            - matches
            - rankings
            - pairs
            - stats
      required:
        - id
        - self
        - name
        - short_name
        - url
        - photo_url
        - category
        - nationality
        - ranking
        - points
        - elo
        - height
        - side
        - hand
        - birthplace
        - birthdate
        - age
        - links
        - updated_at
        - connections
      title: PlayerResource
  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

````