> ## 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 Player Rivals > Retrieve the players a professional padel player has faced most, with the record against each one whoever the partners were on either side. Use it to power rivalry sections in player profiles and match previews. > 🔒 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 /players/{player}/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: /players/{player}/rivals: get: tags: - Player summary: Show Player Rivals description: >- Retrieve the players a professional padel player has faced most, with the record against each one whoever the partners were on either side. Use it to power rivalry sections in player profiles and match previews. > 🔒 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: getPlayerRivals parameters: - name: player in: path required: true description: The player 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: '`PlayerRivalsResource`' content: application/json: schema: $ref: '#/components/schemas/PlayerRivalsResource' '401': $ref: '#/components/responses/AuthenticationException' '404': $ref: '#/components/responses/ModelNotFoundException' '422': $ref: '#/components/responses/ValidationException' components: schemas: PlayerRivalsResource: type: object properties: id: type: integer description: Unique identifier of the player 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 players within the filters. Can be larger than the length of `rivals`, which holds the 10 most frequent. rivals: type: array description: >- Rival players, on the opposite side in every counted match whoever the partners were. `matches_won`, `win_percentage` and `titles` are counted from the side of this player. `finals` are the finals played against the rival and `titles` the ones won. items: type: object properties: id: type: integer self: type: string name: type: string nationality: type: - string - 'null' 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 - nationality - matches_played - matches_won - win_percentage - titles - finals - first_match_at - last_match_at - connections connections: type: object description: Related endpoints. properties: player: type: string description: The player these rivals belong to. required: - player required: - id - self - rivals_count - rivals - connections title: PlayerRivalsResource 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.