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

# Points history

> Get the authenticated customer's paginated points transaction history, most recent first. When the rewards programme is disabled for the tenant, only `enabled: false` is returned.



## OpenAPI

````yaml /api-reference/openapi.json get /account/rewards/points-history
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/points-history:
    parameters: []
    get:
      tags:
        - Rewards
      summary: Points history
      description: >-
        Get the authenticated customer's paginated points transaction history,
        most recent first. 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
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RewardTransaction'
                  meta:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                      lastPage:
                        type: integer
                      perPage:
                        type: integer
                      total:
                        type: integer
              example:
                enabled: true
                data:
                  - id: b1c2d3e4-1111-2222-3333-444455556666
                    customerId: aa11bb22-cc33-dd44-ee55-ff6677889900
                    orderId: 9c8b7a6d-5555-4444-3333-222211110000
                    points: 40
                    balanceAfter: 320
                    type: order
                    description: 'Points earned on order #1042'
                    metadata: null
                    order:
                      id: 9c8b7a6d-5555-4444-3333-222211110000
                      orderId: '1042'
                    createdAt: '2026-06-30T14:12:00.000000Z'
                meta:
                  currentPage: 1
                  lastPage: 3
                  perPage: 20
                  total: 45
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Unauthenticated.
      security:
        - accountAuth: []
components:
  schemas:
    RewardTransaction:
      type: object
      description: A single rewards points transaction.
      properties:
        id:
          type: string
          format: uuid
          description: Transaction ID
        customerId:
          type: string
          format: uuid
          description: Customer ID
        orderId:
          type: string
          format: uuid
          nullable: true
          description: Related order ID, if any
        points:
          type: integer
          description: Points added (positive) or removed (negative)
        balanceAfter:
          type: integer
          description: Points balance after the transaction
        type:
          type: string
          enum:
            - order
            - adjustment
            - bonus
            - refund
            - redemption
            - redemption_reversal
          description: Transaction type
        description:
          type: string
          nullable: true
          description: Transaction description
        metadata:
          type: object
          nullable: true
          description: Additional transaction metadata
        order:
          type: object
          nullable: true
          description: Related order summary, when loaded
          properties:
            id:
              type: string
              format: uuid
            orderId:
              type: string
              description: Human-facing order number
        createdAt:
          type: string
          format: date-time
          description: Transaction timestamp
    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.

````