> ## 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 Pair Rivals > Retrieve the pairs a padel pair has faced most, with the record against each one. > 🔒 This endpoint [requires a **Pro** subscription](https://padelapi.org/billing). Returns the 10 most frequent rivals, sorted by `matches_played` and then by the most recent match. Only finished and retired matches count, and qualification matches and team tournaments are left out, so the record describes main draw play only. It spans the whole history covered, so it surfaces historical rivalries too: in the seasons where only finals are covered, only finals count. ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /pairs/{player1}-{player2}/rivals openapi: 3.1.0 info: title: Padel API – API Reference version: '1.0' description: >- The API for Professional Padel Data. More at https://padelapi.org and https://padelapi.org/llms.txt servers: - url: https://padelapi.org/api security: - http: [] paths: /pairs/{player1}-{player2}/rivals: get: tags: - Pair summary: Show Pair Rivals description: >- Retrieve the pairs a padel pair has faced most, with the record against each one. > 🔒 This endpoint [requires a **Pro** subscription](https://padelapi.org/billing). Returns the 10 most frequent rivals, sorted by `matches_played` and then by the most recent match. Only finished and retired matches count, and qualification matches and team tournaments are left out, so the record describes main draw play only. It spans the whole history covered, so it surfaces historical rivalries too: in the seasons where only finals are covered, only finals count. operationId: getPairRivals parameters: - name: player1 in: path required: true description: The player1 ID schema: type: integer - name: player2 in: path required: true description: The player2 ID schema: type: integer - name: after_date in: query description: Date after to calculate the rivals in `YYYY-MM-DD` format. schema: type: - string - 'null' format: date - name: before_date in: query description: Date before to calculate the rivals in `YYYY-MM-DD` format. schema: type: - string - 'null' format: date - name: level in: query description: >- Tournament level(s) to scope the rivals. Accepts one or multiple comma-separated values (e.g. `major,p1,p2` for all Premier Padel matches) or repeated parameters (e.g. `level[]=major&level[]=p1`). Valid values are the level codes in the [coverage tables](https://padelapi.org/docs#tournaments-coverage). schema: type: string - name: round in: query description: >- Round of the match to calculate the rivals (1 = Final, 2 = Semifinal, 4 = Quarterfinal, 8 = Round of 16, 16 = Round of 32, 32 = Round of 64) schema: type: - integer - 'null' enum: - '1' - '2' - '4' - '8' - '16' - '32' responses: '200': description: '`PairRivalsResource`' content: application/json: schema: $ref: '#/components/schemas/PairRivalsResource' '401': $ref: '#/components/responses/AuthenticationException' '404': $ref: '#/components/responses/ModelNotFoundException' '422': $ref: '#/components/responses/ValidationException' components: schemas: PairRivalsResource: type: object properties: id: type: string description: Unique identifier of the pair these rivals belong to. self: type: string description: Path to this endpoint, relative to `https://padelapi.org`. rivals_count: type: string description: >- Number of distinct rival pairs within the filters. Can be larger than the length of `rivals`, which holds the 10 most frequent. rivals: type: array description: >- Rival pairs, with both players together on the opposite side in every counted match. `id` is the two player IDs joined by a hyphen (e.g. `12-34`). `matches_won`, `win_percentage` and `titles` are counted from the side of this pair. `finals` are the finals played against the rival and `titles` the ones won. items: type: object properties: id: type: string self: type: string name: type: string matches_played: type: integer matches_won: type: integer win_percentage: type: number titles: type: integer finals: type: integer first_match_at: type: - string - 'null' last_match_at: type: - string - 'null' connections: type: object properties: stats: type: string required: - stats required: - id - self - name - matches_played - matches_won - win_percentage - titles - finals - first_match_at - last_match_at - connections connections: type: object description: Related endpoints. properties: pair: type: string description: The pair these rivals belong to. required: - pair required: - id - self - rivals_count - rivals - connections title: PairRivalsResource 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.