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

> Get all active rewards tiers and their thresholds, flagging which tier the authenticated customer is currently on and which they have achieved. When the rewards programme is disabled for the tenant, only `enabled: false` is returned.



## OpenAPI

````yaml /api-reference/openapi.json get /account/rewards/tiers
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:
  /account/rewards/tiers:
    parameters: []
    get:
      tags:
        - Rewards
      summary: List tiers
      description: >-
        Get all active rewards tiers and their thresholds, flagging which tier
        the authenticated customer is currently on and which they have achieved.
        When the rewards programme is disabled for the tenant, only `enabled:
        false` is returned.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  enabled:
                    type: boolean
                  currentPoints:
                    type: integer
                    description: Customer's current points balance
                  lifetimePoints:
                    type: integer
                    description: Customer's lifetime points earned
                  tiers:
                    type: array
                    items:
                      $ref: '#/components/schemas/RewardTier'
              example:
                enabled: true
                currentPoints: 320
                lifetimePoints: 540
                tiers:
                  - id: 3f0d5a2c-1111-2222-3333-444455556666
                    name: Silver
                    slug: silver
                    description: Silver tier members
                    pointsThreshold: 100
                    badgeColor: '#C0C0C0'
                    badgeIcon: star
                    isCurrent: true
                    isAchieved: true
                    perks:
                      - id: d4e5f6a7-1111-2222-3333-444455556666
                        name: Free shipping
                        description: Free delivery on every order
                  - id: 7a1e9b3d-7777-8888-9999-000011112222
                    name: Gold
                    slug: gold
                    description: Gold tier members
                    pointsThreshold: 750
                    badgeColor: '#FFD700'
                    badgeIcon: crown
                    isCurrent: false
                    isAchieved: false
                    perks: []
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Unauthenticated.
      security:
        - accountAuth: []
components:
  schemas:
    RewardTier:
      type: object
      description: A rewards tier with the customer's status against it.
      properties:
        id:
          type: string
          format: uuid
          description: Tier ID
        name:
          type: string
          description: Tier name
        slug:
          type: string
          description: URL-friendly tier identifier
        description:
          type: string
          nullable: true
          description: Tier description
        pointsThreshold:
          type: integer
          description: Lifetime points required to reach this tier
        badgeColor:
          type: string
          nullable: true
          description: Badge colour
        badgeIcon:
          type: string
          nullable: true
          description: Badge icon
        isCurrent:
          type: boolean
          description: Whether this is the customer's current tier
        isAchieved:
          type: boolean
          description: Whether the customer has achieved this tier
        perks:
          type: array
          description: Active perks for the tier
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
              name:
                type: string
              description:
                type: string
                nullable: true
    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
    accountAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is the account token returned from the `Login` endpoint.

````