> ## 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 program members > ⚠️ **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 cursor-paginated list of members of the program. Results can be filtered by id, status, customer_id and created_at, and ordered by created_at, status or customer_id (ascending or descending). The same field cannot be ordered both ascending and descending at the same time. Returns 404 when the program does not exist. List items do not include the `cards` array - use the get-member endpoint to retrieve a member with cards. ## OpenAPI ````yaml /openapi/loyalties-v2.json get /v2/loyalties/programs/{programId}/members openapi: 3.1.0 info: title: Voucherify Loyalty v2 API version: 2.0.0 description: >- Complete OpenAPI specification for the Voucherify Loyalty v2 API. All endpoints require the LOYALTY_V2 feature flag. Combined from per-domain specs: programs.yaml, members.yaml, program-operations.yaml, card-definitions.yaml, earning-rules.yaml, tier-structures.yaml, benefits.yaml, rewards.yaml, examine.yaml servers: - url: '{protocol}://{host}' variables: protocol: default: https enum: - https - http host: default: api.voucherify.io security: - bearerAuth: [] X-App-Id: [] X-App-Token: [] tags: - 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: 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: 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: Benefits description: >- Manage benefit 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: >- Evaluation endpoints that estimate earning opportunities and reward availability for a customer across their loyalty program memberships, without side effects. paths: /v2/loyalties/programs/{programId}/members: get: tags: - Programs summary: List program members 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 cursor-paginated list of members of the program. Results can be filtered by id, status, customer_id and created_at, and ordered by created_at, status or customer_id (ascending or descending). The same field cannot be ordered both ascending and descending at the same time. Returns 404 when the program does not exist. List items do not include the `cards` array - use the get-member endpoint to retrieve a member with cards. operationId: listProgramMembers parameters: - name: programId in: path required: true description: Loyalty program ID (format `lprg_[a-f0-9]+`). schema: type: string pattern: ^lprg_[a-f0-9]+$ - name: limit in: query required: false description: > Maximum number of members to return. Must be between 1 and 100. Defaults to 10 when not provided. schema: type: - integer - 'null' minimum: 1 maximum: 100 default: 10 - name: order in: query required: false description: > Field(s) to order results by. Prefix with `-` for descending order. Accepts a single value or an array of values. Defaults to `-created_at`. Ordering by the same field in both directions simultaneously is rejected. schema: oneOf: - type: array items: type: string enum: - '-created_at' - created_at - status - '-status' - customer_id - '-customer_id' - type: string enum: - '-created_at' - created_at - status - '-status' - customer_id - '-customer_id' - type: 'null' - name: cursor in: query required: false description: > Pagination cursor returned in the `cursor.next` field of a previous response. Must match the pattern `^lcrsmbr_[a-f0-9]+$`. schema: type: - string - 'null' pattern: ^lcrsmbr_[a-f0-9]+$ - name: filters in: query required: false style: deepObject explode: true description: > Field-specific filter conditions, passed as a deep object, e.g. `filters[status][conditions][$is]=ACTIVE`. See the `MemberListFilters` schema for available fields and conditions. schema: oneOf: - $ref: '#/components/schemas/MemberListFilters' - type: 'null' responses: '200': description: Cursor-paginated list of members. content: application/json: schema: $ref: '#/components/schemas/MemberListResponse' '400': description: >- Validation error - request body or query parameters failed validation, or the operation is not allowed in the current resource state. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflict - e.g. duplicate resource or invalid state transition. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: MemberListFilters: type: object description: > Filters for the members list. Each field accepts a `conditions` object; multiple field filters are combined with the `junction` (default AND). properties: junction: description: How multiple field filters are combined. Defaults to `AND`. oneOf: - type: string enum: - AND - OR - type: 'null' id: description: >- Filter by member ID (ID conditions, values matching `^lmbr_[a-f0-9]+$`). oneOf: - $ref: '#/components/schemas/MemberIdFilter' - type: 'null' status: description: >- Filter by member status (enum conditions, values `ACTIVE` or `INACTIVE`). oneOf: - $ref: '#/components/schemas/MemberStatusFilter' - type: 'null' customer_id: description: >- Filter by customer ID (ID conditions, values matching `^cust_[a-zA-Z0-9]+`). oneOf: - $ref: '#/components/schemas/MemberCustomerIdFilter' - type: 'null' created_at: description: Filter by creation date (date conditions). oneOf: - $ref: '#/components/schemas/MemberDateFilter' - type: 'null' additionalProperties: false MemberListResponse: type: object description: Cursor-paginated list of members. properties: data: type: array description: Members on the current page (without the `cards` array). items: $ref: '#/components/schemas/Member' cursor: description: Pagination cursor, or null when there are no more results. oneOf: - $ref: '#/components/schemas/MemberListCursor' - type: 'null' object: type: string const: list description: Object type marker, always `list`. required: - data - cursor - object ErrorResponse: type: object description: Standard error response returned by all Loyalty v2 endpoints. properties: code: type: integer description: HTTP status code of the error. key: type: string description: Machine-readable error key. message: type: string description: Human-readable error message. details: type: string description: Additional details about the error. request_id: type: string description: Identifier of the request that produced the error. MemberIdFilter: type: object description: | ID filter conditions for member IDs. At least one condition is required. properties: conditions: type: object minProperties: 1 properties: $is: description: Value equals. Single value or an array with exactly one value. oneOf: - type: string pattern: ^lmbr_[a-f0-9]+$ - type: array items: type: string pattern: ^lmbr_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $is_not: description: >- Value does not equal. Single value or an array with exactly one value. oneOf: - type: string pattern: ^lmbr_[a-f0-9]+$ - type: array items: type: string pattern: ^lmbr_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $in: description: Value is one of. Single value or an array of 1-100 values. oneOf: - type: string pattern: ^lmbr_[a-f0-9]+$ - type: array items: type: string pattern: ^lmbr_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' $not_in: description: Value is not one of. Single value or an array of 1-100 values. oneOf: - type: string pattern: ^lmbr_[a-f0-9]+$ - type: array items: type: string pattern: ^lmbr_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' additionalProperties: false required: - conditions additionalProperties: false MemberStatusFilter: type: object description: > Enum filter conditions for member status. Allowed values are `ACTIVE` and `INACTIVE`. At least one condition is required. properties: conditions: type: object minProperties: 1 properties: $is: description: Value equals. Single value or an array with exactly one value. oneOf: - type: string enum: - ACTIVE - INACTIVE - type: array items: type: string enum: - ACTIVE - INACTIVE minItems: 1 maxItems: 1 - type: 'null' $is_not: description: >- Value does not equal. Single value or an array with exactly one value. oneOf: - type: string enum: - ACTIVE - INACTIVE - type: array items: type: string enum: - ACTIVE - INACTIVE minItems: 1 maxItems: 1 - type: 'null' $in: description: Value is one of. Single value or an array of 1-10 values. oneOf: - type: string enum: - ACTIVE - INACTIVE - type: array items: type: string enum: - ACTIVE - INACTIVE minItems: 1 maxItems: 10 - type: 'null' $not_in: description: Value is not one of. Single value or an array of 1-10 values. oneOf: - type: string enum: - ACTIVE - INACTIVE - type: array items: type: string enum: - ACTIVE - INACTIVE minItems: 1 maxItems: 10 - type: 'null' additionalProperties: false required: - conditions additionalProperties: false MemberCustomerIdFilter: type: object description: > ID filter conditions for customer IDs. At least one condition is required. properties: conditions: type: object minProperties: 1 properties: $is: description: Value equals. Single value or an array with exactly one value. oneOf: - type: string pattern: ^cust_[a-zA-Z0-9]+ - type: array items: type: string pattern: ^cust_[a-zA-Z0-9]+ minItems: 1 maxItems: 1 - type: 'null' $is_not: description: >- Value does not equal. Single value or an array with exactly one value. oneOf: - type: string pattern: ^cust_[a-zA-Z0-9]+ - type: array items: type: string pattern: ^cust_[a-zA-Z0-9]+ minItems: 1 maxItems: 1 - type: 'null' $in: description: Value is one of. Single value or an array of 1-100 values. oneOf: - type: string pattern: ^cust_[a-zA-Z0-9]+ - type: array items: type: string pattern: ^cust_[a-zA-Z0-9]+ minItems: 1 maxItems: 100 - type: 'null' $not_in: description: Value is not one of. Single value or an array of 1-100 values. oneOf: - type: string pattern: ^cust_[a-zA-Z0-9]+ - type: array items: type: string pattern: ^cust_[a-zA-Z0-9]+ minItems: 1 maxItems: 100 - type: 'null' additionalProperties: false required: - conditions additionalProperties: false MemberDateFilter: type: object description: > Date filter conditions. `$before`/`$after` take date strings; `$is`, `$more_than`, `$less_than` take non-negative integers; `$has_value`/`$is_unknown` are presence checks. Each condition accepts a single value or an array with exactly one value. At least one condition is required. properties: conditions: type: object minProperties: 1 properties: $before: description: Date is before the given date. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $after: description: Date is after the given date. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $is: description: Date matches the given non-negative integer value. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $more_than: description: More than the given non-negative integer value. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $less_than: description: Less than the given non-negative integer value. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $has_value: description: Field has a value (presence check). oneOf: - type: string - type: array maxItems: 1 - type: 'null' $is_unknown: description: Field has no value (absence check). oneOf: - type: string - type: array maxItems: 1 - type: 'null' additionalProperties: false required: - conditions additionalProperties: false Member: type: object description: A loyalty program member. properties: id: type: string pattern: ^lmbr_[a-f0-9]+$ description: Unique member ID. customer_id: type: string pattern: ^cust_[a-zA-Z0-9]+ description: ID of the customer enrolled as this member. program_id: type: string pattern: ^lprg_[a-f0-9]+$ description: ID of the loyalty program the member belongs to. status: type: string enum: - ACTIVE - INACTIVE - DELETED description: Current member status. metadata: type: object description: Free-form metadata attached to the member (empty object when none). created_at: type: string format: date-time description: Timestamp when the member was created (ISO 8601). updated_at: type: - string - 'null' format: date-time description: >- Timestamp when the member was last updated (ISO 8601), or null if never updated. object: type: string const: member description: Object type marker, always `member`. required: - id - customer_id - program_id - status - metadata - created_at - updated_at - object MemberListCursor: type: object description: Pagination cursor. properties: next: type: string description: >- Cursor value to pass as the `cursor` query parameter to fetch the next page. expires_at: type: string format: date-time description: Timestamp when the cursor expires. required: - next 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 ````