> ## 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 Rankings > Retrieve the ranking list for a given week. Snapshots are weekly and indexed by ISO week. Without `date` returns the latest snapshot; with `date` returns the snapshot in effect at that day. Types `official` and `race` are FIP points tables. The `elo` type ranks players by their Elo rating instead, carried in `points`. Only players with at least 5 rated matches in the last 12 months are included in the Elo ranking: a match that never produced a rating, such as a walkover or a bye, does not count towards it. 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 /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: /rankings: get: tags: - Ranking summary: List Rankings description: >- Retrieve the ranking list for a given week. Snapshots are weekly and indexed by ISO week. Without `date` returns the latest snapshot; with `date` returns the snapshot in effect at that day. Types `official` and `race` are FIP points tables. The `elo` type ranks players by their Elo rating instead, carried in `points`. Only players with at least 5 rated matches in the last 12 months are included in the Elo ranking: a match that never produced a rating, such as a walkover or a bye, does not count towards it. 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: listRankings parameters: - name: type in: query description: Ranking type. Either `official`, `race` or `elo`. schema: type: - string - 'null' enum: - official - race - elo - name: category in: query description: Category of the players. Either `men` or `women`. schema: type: - string - 'null' enum: - men - women - name: nationality in: query description: 2 letters country-code to filter the players by nationality. schema: type: - string - 'null' minLength: 2 maxLength: 2 - name: date in: query description: >- Date (`YYYY-MM-DD`) for which the ranking is requested. Defaults to the latest available snapshot. schema: type: - string - 'null' format: date - name: sort_by in: query description: >- Name of the parameter to sort the rankings by. Use `ranking_diff` or `points_diff` to surface the biggest movers of the week. schema: type: - string - 'null' enum: - ranking - points - ranking_diff - points_diff - name: order_by in: query description: Order of the sorting, either `asc` or `desc`. schema: type: - string - 'null' enum: - asc - desc responses: '200': description: Paginated set of `PlayerRankingResource` content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PlayerRankingResource' links: type: object properties: first: type: - string - 'null' last: type: - string - 'null' prev: type: - string - 'null' next: type: - string - 'null' required: - first - last - prev - next meta: type: object properties: current_page: type: integer from: type: - integer - 'null' last_page: type: integer links: type: array description: Generated paginator links. items: type: object properties: url: type: - string - 'null' label: type: string active: type: boolean required: - url - label - active path: type: - string - 'null' description: Base path for paginator generated URLs. per_page: type: integer description: Number of items shown per page. to: type: - integer - 'null' description: Number of the last item in the slice. total: type: integer description: Total number of items being paginated. required: - current_page - from - last_page - links - path - per_page - to - total required: - data - links - meta '401': $ref: '#/components/responses/AuthenticationException' '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. On the `elo` list `points` is the rating the player carried into that week, so it can differ from the `elo` on the player resource, which moves with every match played. Only players with at least 5 rated matches in the last 12 months are ranked on this list. enum: - official - race - elo ranking: description: >- Position in the ranking. On the free plan, only a player's current entry 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 player's previous entry. A player missing from the preceding snapshots re-enters with no movement, instead of a diff spanning the whole absence. On the free plan, only a player's current entry is visible; older snapshots return `hidden_free_plan`. anyOf: - type: integer - type: string enum: - hidden_free_plan points: description: >- Ranking points, or the Elo rating when `type` is `elo`. On the free plan, only a player's current entry 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, or Elo rating points, gained or lost since the player's previous entry. A player missing from the preceding snapshots re-enters with no movement, instead of a diff spanning the whole absence. On the free plan, only a player's current entry 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 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.