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

# Collection

> Retrieve all items from a specific CMS collection by its name.



## OpenAPI

````yaml /api-reference/openapi.json get /cms/collections/{collectionName}
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:
  /cms/collections/{collectionName}:
    parameters:
      - name: collectionName
        in: path
        required: true
        description: The unique name identifier for the collection
        schema:
          type: string
        example: faqs
    get:
      tags:
        - CMS
      summary: Collection
      description: Retrieve all items from a specific CMS collection by its name.
      parameters: []
      responses:
        '200':
          description: CMS collection with items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CmsCollection'
              example:
                id: 30ce94bf-230e-460e-97f8-c5807515c5d0
                name: FAQs
                slug: faqs
                items:
                  - id: cbcb30f9-e88b-475b-a458-47380cdb6b10
                    name: How do subscriptions work?
                    content: >-
                      Our subscriptions deliver a carefully selected shipment to
                      your door on a regular basis. You can choose monthly,
                      quarterly, or bi-annual deliveries. Each shipment includes
                      detailed notes and information about how every item was
                      made.
                    order: 1
                    createdAt: '2025-08-05T15:44:33.000000Z'
                    updatedAt: '2025-08-05T15:44:33.000000Z'
                  - id: 11faa766-21bc-4cb0-989d-7abb93a2a3e0
                    name: Can I skip a delivery?
                    content: >-
                      Yes, you can skip any delivery up to 7 days before your
                      next shipment date. Simply log into your account and
                      manage your subscription settings. You can also pause your
                      subscription for up to 3 months.
                    order: 2
                    createdAt: '2025-08-05T15:44:33.000000Z'
                    updatedAt: '2025-08-05T15:44:33.000000Z'
                  - id: bb28663d-d37b-469c-bad2-235c5a86d6a7
                    name: What if I do not like an item?
                    content: >-
                      We offer a satisfaction guarantee. If you are not happy
                      with any item in your shipment, contact us within 30 days
                      and we will provide a credit or replacement. We want you
                      to love every delivery!
                    order: 3
                    createdAt: '2025-08-05T15:44:33.000000Z'
                    updatedAt: '2025-08-05T15:44:33.000000Z'
                  - id: 18e6da9f-86a4-43e1-8667-8a19aa5057f6
                    name: Do you ship internationally?
                    content: >-
                      Currently we ship within the UK only. We are working on
                      expanding to EU countries in 2025. UK shipping is free on
                      all subscription orders and orders over £50.
                    order: 4
                    createdAt: '2025-08-05T15:44:33.000000Z'
                    updatedAt: '2025-08-05T15:44:33.000000Z'
                  - id: e58aef3b-fcea-4444-88b6-441ee059263f
                    name: How do I cancel my subscription?
                    content: >-
                      You can cancel your subscription at any time through your
                      account settings. There are no cancellation fees or
                      commitments. If you cancel before your next billing date,
                      you won't be charged for future shipments.
                    order: 5
                    createdAt: '2025-08-05T15:44:33.000000Z'
                    updatedAt: '2025-08-05T15:44:33.000000Z'
                createdAt: '2025-08-05T15:44:33.000000Z'
                updatedAt: '2025-08-05T15:44:33.000000Z'
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              example:
                message: string
components:
  schemas:
    CmsCollection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the collection
        name:
          type: string
          description: Collection name
        slug:
          type: string
          description: URL-friendly collection identifier
        items:
          type: array
          items:
            $ref: '#/components/schemas/CmsItem'
          description: Collection items sorted by order
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp
    CmsItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the item
        name:
          type: string
          description: Item name
        content:
          type: string
          description: Item content (may contain HTML)
        order:
          type: integer
          description: Display order within collection
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp
  securitySchemes:
    tenantAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your API token.
      bearerFormat: JWT

````