> ## 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.

# List Event Occurrences

> List the occurrences of a recurring event, optionally filtered by date range and status. When no start date or status filter is supplied, only upcoming occurrences are returned. If the event is not recurring, an empty list is returned with an explanatory message.



## OpenAPI

````yaml /api-reference/openapi.json get /events/{event}/occurrences
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 catalog 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: Search
    description: Search functionality 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/{event}/occurrences:
    parameters:
      - name: event
        in: path
        required: true
        description: The unique identifier of the event.
        schema:
          type: string
          format: uuid
        example: b7a4c2e1-8f3d-4a6b-9c2e-1d5f7a8b3c4d
    get:
      tags:
        - Events
      summary: List Event Occurrences
      description: >-
        List the occurrences of a recurring event, optionally filtered by date
        range and status. When no start date or status filter is supplied, only
        upcoming occurrences are returned. If the event is not recurring, an
        empty list is returned with an explanatory message.
      parameters:
        - name: startDate
          in: query
          required: false
          description: Only include occurrences on or after this date (YYYY-MM-DD).
          schema:
            type: string
            format: date
          example: '2026-08-01'
        - name: endDate
          in: query
          required: false
          description: Only include occurrences on or before this date (YYYY-MM-DD).
          schema:
            type: string
            format: date
          example: '2026-11-01'
        - name: status
          in: query
          required: false
          description: Filter occurrences by status.
          schema:
            type: string
            enum:
              - active
              - cancelled
              - postponed
          example: active
      responses:
        '200':
          description: The list of occurrences.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/EventOccurrence'
                  total:
                    type: integer
                    description: The number of occurrences returned.
              example:
                data:
                  - id: 9a2b3c4d-5e6f-4071-8a9b-0c1d2e3f4a5b
                    date: '2026-08-15'
                    formattedDate: Aug 15, 2026
                    startTime: '19:00'
                    endTime: '22:00'
                    status: active
                    location: The Grand Hall
                    maxTickets: 100
                    ticketsSold: 58
                    ticketsAvailable: 42
                    isSoldOut: false
                total: 1
        '404':
          description: Event not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: No query results for model [Event].
components:
  schemas:
    EventOccurrence:
      type: object
      description: A single occurrence of a recurring event.
      properties:
        id:
          type: string
          format: uuid
          description: The occurrence identifier.
        date:
          type: string
          format: date
          description: The occurrence date (YYYY-MM-DD).
        formattedDate:
          type: string
          description: A human-readable date, e.g. "Aug 15, 2026".
        startTime:
          type: string
          nullable: true
          description: The start time (HH:MM).
        endTime:
          type: string
          nullable: true
          description: The end time (HH:MM).
        status:
          type: string
          enum:
            - active
            - cancelled
            - postponed
          description: The occurrence status.
        location:
          type: string
          nullable: true
          description: The occurrence location.
        maxTickets:
          type: integer
          nullable: true
          description: The maximum ticket capacity for the occurrence.
        ticketsSold:
          type: integer
          description: The number of tickets sold for the occurrence.
        ticketsAvailable:
          type: integer
          description: The number of tickets still available.
        isSoldOut:
          type: boolean
          description: Whether the occurrence is sold out.
    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

````