> ## 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 Tournament Players > Endpoint to retrieve the players entered in a specific tournament, from the official entry list. Each player comes with the draw they are entered in, their position in the entry list and their pair or, in [team tournaments](https://padelapi.org/docs/guides/team-tournaments), their national team. The list is available from a few days before the tournament starts. Until then the response is empty. ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /tournaments/{tournament}/players 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: /tournaments/{tournament}/players: get: tags: - Tournament summary: List Tournament Players description: >- Endpoint to retrieve the players entered in a specific tournament, from the official entry list. Each player comes with the draw they are entered in, their position in the entry list and their pair or, in [team tournaments](https://padelapi.org/docs/guides/team-tournaments), their national team. The list is available from a few days before the tournament starts. Until then the response is empty. operationId: listTournamentPlayers parameters: - name: tournament in: path required: true description: The tournament ID schema: type: integer - name: category in: query description: Category of the players. Either `men` or `women`. schema: type: - string - 'null' enum: - men - women - name: draw in: query description: >- Draw the players are entered in: `main`, `qualy`, or `all` for every draw. Defaults to `all`. schema: type: - string - 'null' enum: - main - qualy - all - name: page in: query description: Page number to return, starting at `1`. schema: type: - integer - 'null' default: 1 minimum: 1 - name: per_page in: query description: >- Number of results per page, from `1` to `50`. Larger values return `50`. schema: type: - integer - 'null' default: 15 minimum: 1 responses: '200': description: Paginated set of `TournamentPlayerResource` content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/TournamentPlayerResource' 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' '404': $ref: '#/components/responses/ModelNotFoundException' '422': $ref: '#/components/responses/ValidationException' components: schemas: TournamentPlayerResource: type: object properties: id: type: integer description: Unique identifier of the player. self: type: string description: Path to the player's endpoint, relative to `https://padelapi.org`. name: type: string description: Full name of the player. nationality: type: - string - 'null' description: >- ISO 3166-1 alpha-2 country code, uppercase. `null` when not available. draw: type: string description: >- Draw the player is entered in. `qualy` is only listed for tournaments with qualifying coverage. enum: - main - qualy position: type: string description: >- Position of the entry in the official entry list of its draw, ordered by team points. Only in pair tournaments. seed: type: string description: >- Entry code for special entries (e.g. `"WC"` for a wildcard), same marker as `seeds` in the tournament matches; `null` when entered by ranking. Seed numbers are only known once the draw is published, in the matches. Only in pair tournaments. team: type: string description: >- National team the player is part of, matching `tie.team_1` and `tie.team_2` in the tournament matches. Only in team tournaments. connections: type: string description: Related endpoints for this entry. required: - id - self - name - nationality - draw - connections title: TournamentPlayerResource 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.