> ## 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 Editions > Endpoint to retrieve every edition of the same recurring event across seasons (e.g. Italy Major 2023, 2024, 2025...), including the requested tournament itself, ordered by start date. Editions are matched by tournament name, level and country, so the list is a best effort when an event changes its name completely between seasons. ## OpenAPI ````yaml https://padelapi.org/docs/api.json get /tournaments/{tournament}/editions 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: /tournaments/{tournament}/editions: get: tags: - Tournament summary: List Tournament Editions description: >- Endpoint to retrieve every edition of the same recurring event across seasons (e.g. Italy Major 2023, 2024, 2025...), including the requested tournament itself, ordered by start date. Editions are matched by tournament name, level and country, so the list is a best effort when an event changes its name completely between seasons. operationId: listTournamentEditions parameters: - name: tournament in: path required: true description: The tournament 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 ````