> ## 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 Season Tournaments > Endpoint to retrieve all tournaments of a specific season. For a more detailed filtering of tournaments, use the "List Tournaments" endpoint. Recommended as the entry point for weekly tournament syncs — see the [Data Synchronization guide](https://padelapi.org/docs/guides/data-synchronization#tournaments). ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /seasons/{season}/tournaments 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: /seasons/{season}/tournaments: get: tags: - Season summary: List Season Tournaments description: >- Endpoint to retrieve all tournaments of a specific season. For a more detailed filtering of tournaments, use the "List Tournaments" endpoint. Recommended as the entry point for weekly tournament syncs — see the [Data Synchronization guide](https://padelapi.org/docs/guides/data-synchronization#tournaments). operationId: listSeasonTournaments parameters: - name: season in: path required: true description: The season ID schema: type: integer responses: '200': description: Paginated set of `TournamentResource` content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/TournamentResource' 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' components: schemas: TournamentResource: type: object properties: id: type: integer description: >- Unique identifier of this tournament edition. A new edition of the same event gets its own `id`; use `connections.editions` to walk the history. self: type: string description: >- Path to this tournament's endpoint, relative to `https://padelapi.org`. name: type: string description: >- Official name of this edition, including the title sponsor when there is one (e.g. `Oysho Milano P1`). Sponsors change between editions, so match on `id` rather than on this field. url: type: - string - 'null' description: Public tournament page. `null` when the tournament has no page. location: type: string description: City hosting the tournament. venue: type: - object - 'null' description: >- Club or arena hosting the tournament. `null` when the venue has not been announced. properties: name: type: - string - 'null' address: type: - string - 'null' required: - name - address country: type: string description: ISO 3166-1 alpha-2 country code, uppercase. timezone: type: string description: >- IANA timezone of the venue (e.g. `Europe/Rome`). This is the timezone used to serialize the `_local` times of the tournament's matches. level: type: string description: >- Category of the tournament within its circuit. Premier Padel runs `major`, `p1`, `p2` and `finals`; the FIP Tour runs the `fip_*` levels; `wpt_*` and `ppt_*` cover the historical World Padel Tour and Padel Pro Tour. Accepted as a comma-separated filter on [`GET /tournaments`](https://padelapi.org/docs/api-reference/tournament/list-tournaments). enum: - major - p1 - p2 - finals - fip_platinum - fip_gold - fip_silver - fip_other - wpt_master - wpt_1000 - wpt_500 - wpt_final - ppt_master - ppt_final - ppt_international - ppt_promotional - ppt_other status: type: string description: >- Current state of the tournament. See the [statuses reference](https://padelapi.org/docs/statuses#tournament-statuses) for the full list and the [data synchronization guide](https://padelapi.org/docs/guides/data-synchronization#tournaments) for how to keep it up to date. enum: - pending - live - finished - cancelled court_type: description: Surface setup of the courts. `null` when it has not been announced. anyOf: - type: 'null' - type: string enum: - indoor - outdoor - covered prize: type: - object - 'null' description: >- Total prize money on offer, with `amount` as a whole unit of `currency` (ISO 4217). `null` when the tournament does not publish it. properties: amount: type: integer currency: type: string required: - amount - currency start_date: type: string description: First day of play, as `YYYY-MM-DD`. end_date: type: string description: >- Last day of play, as `YYYY-MM-DD`, normally the day the finals are played. winners: type: - object - 'null' description: >- Pairs that won the tournament, keyed by category (`men`, `women`). `null` until the tournament reaches `finished`, and a category is absent when its final has no confirmed winner. additionalProperties: $ref: '#/components/schemas/MatchPairResource' links: type: string description: >- External links related to the tournament. `null` when none are available. updated_at: type: string description: >- ISO 8601 timestamp of the last change to any field of this tournament. Use it to skip records you have already processed. connections: type: string description: >- Related endpoints for this tournament. `videos` is only present when the tournament has video content. required: - id - self - name - url - location - venue - country - timezone - level - status - court_type - prize - start_date - end_date - winners - links - updated_at - connections title: TournamentResource MatchPairResource: type: array prefixItems: - type: object properties: id: type: integer self: type: string name: type: string side: anyOf: - type: 'null' - type: string enum: - drive - backhand connections: type: string required: - id - self - name - side - connections minItems: 1 maxItems: 1 additionalItems: false title: MatchPairResource 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 securitySchemes: http: type: http scheme: bearer ````