> ## 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 FIP 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. Each entry exposes `type`, `category`, `ranking`, `ranking_diff`, `points`, `points_diff` and `date` (Monday of the ISO week the snapshot belongs to). 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 FIP 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. Each entry exposes `type`, `category`, `ranking`, `ranking_diff`, `points`, `points_diff` and `date` (Monday of the ISO week the snapshot belongs to). 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` or `race`. schema: type: - string - 'null' enum: - official - race - 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 self: type: string name: type: string category: type: string nationality: type: string type: type: string 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 connections: type: object properties: rankings: type: string 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 ````