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

# List Tier Structure Activities

> ⚠️ **BETA endpoint**

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

Returns a paginated, cursor-based list of activities (audit log) for a tier structure.
Includes events for the tier structure itself and its nested tiers.




## OpenAPI

````yaml /openapi/loyalties-v2.json get /v2/loyalties/tier-structures/{id}/activities
openapi: 3.1.0
info:
  title: Voucherify Loyalty v2 API
  version: 2.0.0
  description: >-
    Complete API documentation for Voucherify Loyalty v2 system. Requires
    LOYALTY_V2 feature flag.
servers:
  - url: https://api.voucherify.io
    description: Production
security:
  - bearerAuth: []
    X-App-Id: []
    X-App-Token: []
tags:
  - name: Card Definitions
    description: >-
      CRUD operations, lifecycle management, and activity history for card
      definitions. Card definitions describe the configuration for loyalty
      cards, including code generation, points expiration, earning/spending
      limits, pending points, refunds, and balance settings.
  - name: Programs
    description: >-
      Loyalty program CRUD, lifecycle management, program-scoped resource
      assignments (card definitions, earning rules, rewards, tier structures),
      member management (create, list, get, activate, deactivate, delete), card
      operations (points adjustment, pending points, expiring points,
      transactions), reward purchases, and activity history.
  - name: Earning Rules
    description: >-
      Manage earning rules that define how customers earn points or receive
      incentives based on triggers (events, segments, custom events). Includes
      CRUD, lifecycle, and activity history.
  - name: Tier Structures
    description: >-
      CRUD operations, lifecycle management, and activity history for tier
      structures. Includes nested tier definitions (create, list, update,
      delete) within tier structures. Tier structures define the tiering model
      for loyalty programs — how members qualify for and move between tiers.
  - name: Incentives
    description: >-
      Manage incentive definitions (fixed points, proportional points, material,
      digital). Includes CRUD, lifecycle transitions, and activity history.
  - name: Rewards
    description: >-
      CRUD, lifecycle operations, and activity history for reward definitions.
      Rewards can be material (product/SKU) or digital (discount coupons, gift
      vouchers).
  - name: Examine
    description: Examines the earning of loyalty points for a loyalty program member.
paths:
  /v2/loyalties/tier-structures/{id}/activities:
    parameters:
      - $ref: '#/components/parameters/TierStructureId'
    get:
      tags:
        - Tier Structures
      summary: List Tier Structure Activities
      description: >
        ⚠️ **BETA endpoint**


        This is a work-in-progress documentation of a BETA endpoint. The
        parameters, fields, request and response bodies, and other data may
        subject to change. If you want to share feedback or improvements,
        contact Voucherify support or your Technical Account Manager.


        Returns a paginated, cursor-based list of activities (audit log) for a
        tier structure.

        Includes events for the tier structure itself and its nested tiers.
      operationId: listTierStructureActivities
      parameters:
        - name: filters[junction]
          in: query
          required: false
          schema:
            type: string
            enum:
              - AND
              - OR
          description: Logical junction for combining filter conditions.
        - name: filters[id][conditions][$is]
          in: query
          required: false
          schema:
            type: string
          description: Filter by exact activity ID.
        - name: filters[id][conditions][$is_not]
          in: query
          required: false
          schema:
            type: string
          description: Exclude activities with this ID.
        - name: filters[id][conditions][$in]
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            maxItems: 100
          description: Filter by multiple activity IDs.
        - name: filters[id][conditions][$not_in]
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            maxItems: 100
          description: Exclude activities with these IDs.
        - name: filters[type][conditions][$is]
          in: query
          required: false
          schema:
            type: string
            enum:
              - vl.tier_structure.created
              - vl.tier_structure.updated
              - vl.tier_structure.deleted
              - vl.tier_structure.activated
              - vl.tier_structure.deactivated
              - vl.tier_structure.drafted
              - vl.tier_structure.assigned
              - vl.tier_structure.unassigned
              - vl.tier_structure.tier.created
              - vl.tier_structure.tier.updated
              - vl.tier_structure.tier.deleted
          description: Filter by exact activity type.
        - name: filters[type][conditions][$is_not]
          in: query
          required: false
          schema:
            type: string
            enum:
              - vl.tier_structure.created
              - vl.tier_structure.updated
              - vl.tier_structure.deleted
              - vl.tier_structure.activated
              - vl.tier_structure.deactivated
              - vl.tier_structure.drafted
              - vl.tier_structure.assigned
              - vl.tier_structure.unassigned
              - vl.tier_structure.tier.created
              - vl.tier_structure.tier.updated
              - vl.tier_structure.tier.deleted
          description: Exclude activities with this type.
        - name: filters[type][conditions][$in]
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - vl.tier_structure.created
                - vl.tier_structure.updated
                - vl.tier_structure.deleted
                - vl.tier_structure.activated
                - vl.tier_structure.deactivated
                - vl.tier_structure.drafted
                - vl.tier_structure.assigned
                - vl.tier_structure.unassigned
                - vl.tier_structure.tier.created
                - vl.tier_structure.tier.updated
                - vl.tier_structure.tier.deleted
            maxItems: 10
          description: Filter by multiple activity types.
        - name: filters[type][conditions][$not_in]
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - vl.tier_structure.created
                - vl.tier_structure.updated
                - vl.tier_structure.deleted
                - vl.tier_structure.activated
                - vl.tier_structure.deactivated
                - vl.tier_structure.drafted
                - vl.tier_structure.assigned
                - vl.tier_structure.unassigned
                - vl.tier_structure.tier.created
                - vl.tier_structure.tier.updated
                - vl.tier_structure.tier.deleted
            maxItems: 10
          description: Exclude activities with these types.
        - name: filters[created_at][conditions][$before]
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Filter for activities created before this date.
        - name: filters[created_at][conditions][$after]
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Filter for activities created after this date.
        - name: filters[created_at][conditions][$is]
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
          description: Filter for activities created exactly N days ago.
        - name: filters[created_at][conditions][$more_than]
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
          description: Filter for activities created more than N days ago.
        - name: filters[created_at][conditions][$less_than]
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
          description: Filter for activities created less than N days ago.
        - name: filters[created_at][conditions][$has_value]
          in: query
          required: false
          schema:
            type: string
          description: Filter for records where created_at has a value.
        - name: filters[created_at][conditions][$is_unknown]
          in: query
          required: false
          schema:
            type: string
          description: Filter for records where created_at is unknown.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          description: Maximum number of results to return (1-100).
        - name: order
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - created_at
                - '-created_at'
          description: 'Sort order. Prefix with `-` for descending. Default: `-created_at`.'
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: Cursor for pagination. Obtained from a previous list response.
      responses:
        '200':
          description: List of tier structure activities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TierStructureActivityListResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    TierStructureId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: Unique tier structure identifier.
  schemas:
    TierStructureActivityListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/TierStructureActivity'
        cursor:
          oneOf:
            - $ref: '#/components/schemas/PaginationCursor'
            - type: 'null'
        object:
          type: string
          enum:
            - list
      required:
        - data
        - object
    TierStructureActivity:
      type: object
      properties:
        id:
          type: string
          description: Unique activity identifier.
        tier_structure_id:
          type: string
          description: ID of the tier structure this activity belongs to.
        type:
          type: string
          enum:
            - vl.tier_structure.created
            - vl.tier_structure.updated
            - vl.tier_structure.deleted
            - vl.tier_structure.activated
            - vl.tier_structure.deactivated
            - vl.tier_structure.drafted
            - vl.tier_structure.assigned
            - vl.tier_structure.unassigned
            - vl.tier_structure.tier.created
            - vl.tier_structure.tier.updated
            - vl.tier_structure.tier.deleted
          description: Activity event type.
        data:
          type: object
          description: Event-specific payload containing the affected resource snapshots.
          additionalProperties: true
        created_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the activity occurred.
        group_id:
          oneOf:
            - type: string
            - type: 'null'
          description: Group identifier for correlated activities.
        source:
          oneOf:
            - $ref: '#/components/schemas/ActivitySource'
            - type: 'null'
          description: Source channel that triggered the activity.
      required:
        - id
        - tier_structure_id
        - type
        - data
        - created_at
    PaginationCursor:
      type: object
      description: Cursor for fetching the next page of results.
      properties:
        next:
          type: string
          description: >-
            Cursor token to pass as the `cursor` query parameter for the next
            page.
        expires_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp when this cursor expires.
      required:
        - next
        - expires_at
    ErrorResponse:
      type: object
      description: Standard error response.
      properties:
        code:
          type: integer
          description: HTTP status code.
        key:
          type: string
          description: Machine-readable error key.
        message:
          type: string
          description: Human-readable error message.
        details:
          type: string
          description: Additional error details.
        request_id:
          type:
            - string
            - 'null'
          description: Request identifier for tracing.
        resource_id:
          type: string
          description: Related resource identifier (when applicable).
        resource_type:
          type: string
          description: Related resource type (when applicable).
      required:
        - code
        - key
        - message
    ActivitySource:
      type: object
      description: Source information for an activity.
      properties:
        channel:
          type: string
          enum:
            - USER_PORTAL
            - API
            - CLIENT_API
            - INTERNAL
          description: Channel through which the activity was triggered.
        user:
          type: object
          properties:
            id:
              type: string
              description: User identifier.
        api_key:
          type: object
          properties:
            name:
              type: string
            app_id:
              type: string
            client_app_id:
              type: string
  responses:
    BadRequest:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    X-App-Id:
      type: apiKey
      name: X-App-Id
      in: header
    X-App-Token:
      type: apiKey
      name: X-App-Token
      in: header

````