> ## 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 Players > Endpoint to retrieve professional padel players with filtering options by name, nationality, category, birthplace, and playing side. ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /players 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: get: tags: - Player summary: List Players description: >- Endpoint to retrieve professional padel players with filtering options by name, nationality, category, birthplace, and playing side. operationId: listPlayers parameters: - name: name in: query description: >- Name of the player to search for. To search for multiple players, separate names with commas. schema: type: - string - 'null' - name: nationality in: query description: 2 letters country-code of the player. schema: type: - string - 'null' minLength: 2 maxLength: 2 - name: category in: query description: Category of the player. Either `men` or `women`. schema: type: - string - 'null' enum: - men - women - name: birthplace in: query description: Name of the birthplace of the player. schema: type: - string - 'null' - name: side in: query description: Side of the player, either `drive` or `backhand`. schema: type: - string - 'null' enum: - drive - backhand - name: updated_after in: query description: Filter players updated after this datetime in ISO 8601 format. schema: type: - string - 'null' format: date-time - name: updated_before in: query description: Filter players updated before this datetime in ISO 8601 format. schema: type: - string - 'null' format: date-time - name: sort_by in: query description: Name of the parameter to sort the tournaments by. schema: type: - string - 'null' enum: - name - ranking - points - elo - height - birthdate - updated_at - 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 `PlayerResource` content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PlayerResource' 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: PlayerResource: type: object properties: id: type: integer description: >- Unique identifier of the player. Stable across seasons, use it to reference the player from your own data. self: type: string description: Path to this player's endpoint, relative to `https://padelapi.org`. name: type: string description: Full name of the player, without accents or special characters. short_name: type: string description: Short display name, usually the surname. url: type: - string - 'null' description: Public player profile. `null` when the player has no profile page. photo_url: type: - string - 'null' description: Public URL of the player's photo. `null` when no photo is available. category: type: string description: >- Competition category the player competes in. Players never appear in both. enum: - men - women nationality: type: string description: >- ISO 3166-1 alpha-2 country code, uppercase. Reflects the country the player represents, which can differ from `birthplace`. ranking: type: string description: >- Current position in the official ranking. `null` for unranked players. points: type: integer description: >- Points backing the official ranking position. `null` for unranked players. Use [`GET /players/{player}/rankings`](https://padelapi.org/docs/api-reference/player/list-player-rankings) for the historical series. elo: type: - integer - 'null' description: >- Strength rating relative to the rest of the field, updated after every completed match. Every player enters the system at `1000`. See the [Elo rating guide](https://padelapi.org/docs/guides/padel-elo-rating) for how it is calculated and how to read it. height: type: - integer - 'null' description: Height in centimetres. `null` when not available. side: description: >- Side of the court the player covers. `drive` is the forehand side, `backhand` the other one. `null` when the player has no established side. anyOf: - type: 'null' - type: string enum: - drive - backhand hand: description: Dominant hand. `null` when not available. anyOf: - type: 'null' - type: string enum: - left - right birthplace: type: - string - 'null' description: City or region the player was born in. `null` when not available. birthdate: type: - string - 'null' description: Date of birth, as `YYYY-MM-DD`. `null` when not available. age: type: - string - 'null' description: >- Age in years derived from `birthdate`. `null` when the birthdate is not available. links: type: string description: >- External profile URLs for the player. `null` when none are available. updated_at: type: string description: >- ISO 8601 timestamp of the last change to any field of this player, including ranking and Elo. Use it to skip records you have already processed. connections: type: object description: Related endpoints for this player. properties: matches: type: string description: Matches played by this player. rankings: type: string description: Historical ranking positions and points for this player. pairs: type: string description: Partners this player has played with. stats: type: string description: Aggregated career and season statistics for this player. required: - matches - rankings - pairs - stats required: - id - self - name - short_name - url - photo_url - category - nationality - ranking - points - elo - height - side - hand - birthplace - birthdate - age - links - updated_at - connections title: PlayerResource 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 ````