> ## 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 Rankings > Retrieve every ranking published for a player — multiple types (`official`, `race`) — as the current snapshot or as a historical series. Without `after_date`/`before_date` it returns the latest entry for each ranking type. With `after_date` and/or `before_date` it returns the chronological series of weekly snapshots within that range, so you can plot ranking evolution and spot peaks and lows. On the free plan, only the latest weekly snapshot is visible: ranking values from older snapshots return `hidden_free_plan`. Paid plans include the full ranking history. ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /players/{player}/rankings 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}/rankings: get: tags: - Player summary: List Player Rankings description: >- Retrieve every ranking published for a player — multiple types (`official`, `race`) — as the current snapshot or as a historical series. Without `after_date`/`before_date` it returns the latest entry for each ranking type. With `after_date` and/or `before_date` it returns the chronological series of weekly snapshots within that range, so you can plot ranking evolution and spot peaks and lows. On the free plan, only the latest weekly snapshot is visible: ranking values from older snapshots return `hidden_free_plan`. Paid plans include the full ranking history. operationId: listPlayerRankings parameters: - name: player in: path required: true description: The player ID schema: type: integer - name: after_date in: query description: Start date of the historical series in `YYYY-MM-DD` format. schema: type: - string - 'null' format: date - name: before_date in: query description: End date of the historical series in `YYYY-MM-DD` format. schema: type: - string - 'null' format: date - name: type in: query description: Filter by ranking type. Omit to return both `official` and `race`. schema: type: - string - 'null' enum: - official - race responses: '200': description: '' content: application/json: schema: type: array items: $ref: '#/components/schemas/PlayerRankingResource' '401': $ref: '#/components/responses/AuthenticationException' '404': $ref: '#/components/responses/ModelNotFoundException' '422': $ref: '#/components/responses/ValidationException' components: schemas: PlayerRankingResource: type: object properties: id: type: integer description: Unique identifier of the ranked player. self: type: string description: Path to the player's profile, relative to `https://padelapi.org`. name: type: string description: Full name of the player, without accents or special characters. category: type: string description: >- Competition category this ranking belongs to. Men and women are ranked separately, so positions repeat across categories. enum: - men - women nationality: type: string description: ISO 3166-1 alpha-2 country code of the player, uppercase. type: type: string description: >- Which ranking list this entry belongs to. A player has one entry per type, so filter on this field when plotting a single series. The `ranking` and `points` on the player resource mirror the current `official` values. enum: - official - race ranking: description: >- Position in the ranking. On the free plan, only the latest weekly snapshot is visible; older snapshots return `hidden_free_plan`. Paid plans include the full ranking history. anyOf: - type: integer - type: string enum: - hidden_free_plan ranking_diff: description: >- Positions gained or lost since the previous weekly snapshot. On the free plan, only the latest weekly snapshot is visible; older snapshots return `hidden_free_plan`. anyOf: - type: integer - type: string enum: - hidden_free_plan points: description: >- Ranking points. On the free plan, only the latest weekly snapshot is visible; older snapshots return `hidden_free_plan`. Paid plans include the full ranking history. anyOf: - type: integer - type: string enum: - hidden_free_plan points_diff: description: >- Points gained or lost since the previous weekly snapshot. On the free plan, only the latest weekly snapshot is visible; older snapshots return `hidden_free_plan`. anyOf: - type: integer - type: string enum: - hidden_free_plan date: type: string description: >- Monday of the ISO week this snapshot belongs to, as `YYYY-MM-DD`. Snapshots are weekly, so this is the date the entry took effect rather than the day it was published. connections: type: object description: Related endpoints for this ranking entry. properties: rankings: type: string description: Full ranking history for this player. required: - rankings required: - id - self - name - category - nationality - type - ranking - ranking_diff - points - points_diff - date - connections title: PlayerRankingResource 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 ````