> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marzipan.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Recurring Event Dates

> List the upcoming active occurrences for a recurring event product within an optional date range. If the product is not a recurring event, an empty list is returned with an explanatory message. An event can be confined to one or more date ranges, and this endpoint reads the materialised occurrences, so no dates are returned for the gaps between them. Treat the returned dates as authoritative rather than re-deriving them from `recurrenceType` and a start date.



## OpenAPI

````yaml /api-reference/openapi.json get /events/recurring/{product}/dates
openapi: 3.0.0
info:
  title: Marzipan API
  version: 1.0.0
servers:
  - url: https://api.marzipan.co/v1
security:
  - tenantAuth: []
tags:
  - name: Account
    description: >-
      Account management endpoints including registration, login, and user
      details
  - name: Carts
    description: Shopping cart management endpoints
  - name: Products
    description: Product catalogue and search endpoints
  - name: Subscriptions
    description: Subscription management and renewal endpoints
  - name: CMS
    description: Content management system endpoints
  - name: Messaging
    description: Message and communication endpoints
  - name: Settings
    description: >-
      Storefront settings and market detection used to configure the web
      components and checkout.
  - name: Analytics
    description: Storefront visit and attribution tracking.
  - name: Rewards
    description: >-
      Loyalty and rewards programme endpoints for the authenticated customer,
      covering points balance, tier status, perks, exclusive products and
      transaction history.
  - name: Forms
    description: Render and submit dynamic storefront forms defined in the CMS.
  - name: Events
    description: >-
      Check event availability, browse occurrences and recurring dates, generate
      ticket QR codes, and manage event waitlists (join, leave, check status,
      and claim promoted spots).
paths:
  /events/recurring/{product}/dates:
    parameters:
      - name: product
        in: path
        required: true
        description: The unique identifier of the event product.
        schema:
          type: string
          format: uuid
        example: 3f1c9d20-5b8e-4c11-a2d7-6e9f0a1b2c3d
    get:
      tags:
        - Events
      summary: Get Recurring Event Dates
      description: >-
        List the upcoming active occurrences for a recurring event product
        within an optional date range. If the product is not a recurring event,
        an empty list is returned with an explanatory message. An event can be
        confined to one or more date ranges, and this endpoint reads the
        materialised occurrences, so no dates are returned for the gaps between
        them. Treat the returned dates as authoritative rather than re-deriving
        them from `recurrenceType` and a start date.
      parameters:
        - name: startDate
          in: query
          required: false
          description: Start of the date range (YYYY-MM-DD). Defaults to today.
          schema:
            type: string
            format: date
          example: '2026-08-01'
        - name: endDate
          in: query
          required: false
          description: >-
            End of the date range (YYYY-MM-DD). Defaults to three months from
            today.
          schema:
            type: string
            format: date
          example: '2026-11-01'
      responses:
        '200':
          description: The list of available occurrence dates.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RecurringDate'
              example:
                data:
                  - id: 9a2b3c4d-5e6f-4071-8a9b-0c1d2e3f4a5b
                    date: '2026-08-15'
                    startDate: '2026-08-15'
                    endDate: '2026-08-15'
                    startTime: '19:00'
                    endTime: '22:00'
                    location: The Grand Hall
                    status: active
                    ticketsAvailable: 42
                    isSoldOut: false
                    formattedDateTime: Sat 15 Aug 2026, 7:00 PM
        '404':
          description: Product not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: No query results for model [Product].
components:
  schemas:
    RecurringDate:
      type: object
      description: An available date for a recurring event product.
      properties:
        id:
          type: string
          format: uuid
          description: The occurrence identifier.
        date:
          type: string
          format: date
          description: The occurrence date (YYYY-MM-DD).
        startDate:
          type: string
          format: date
          description: The occurrence start date (YYYY-MM-DD).
        endDate:
          type: string
          format: date
          description: The occurrence end date (YYYY-MM-DD).
        startTime:
          type: string
          nullable: true
          description: The start time (HH:MM).
        endTime:
          type: string
          nullable: true
          description: The end time (HH:MM).
        location:
          type: string
          nullable: true
          description: The occurrence location.
        status:
          type: string
          enum:
            - active
            - cancelled
            - postponed
          description: The occurrence status.
        ticketsAvailable:
          type: integer
          description: The number of tickets available.
        isSoldOut:
          type: boolean
          description: Whether the occurrence is sold out.
        formattedDateTime:
          type: string
          description: A human-readable date and time for display.
    Error:
      type: object
      properties:
        message:
          type: string
          description: Error message
      required:
        - message
  securitySchemes:
    tenantAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your API token.
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.