> ## 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 member reward purchases > ⚠️ **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. Lists reward transactions of type `PURCHASE` for the given program member, with cursor-based pagination. Supports filtering by transaction id, reward id and creation date. ## OpenAPI ````yaml /openapi/loyalties-v2.json get /v2/loyalties/programs/{programId}/members/{memberId}/rewards/purchases 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/{memberId}/rewards/purchases: get: tags: - Programs summary: List member reward purchases 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. Lists reward transactions of type `PURCHASE` for the given program member, with cursor-based pagination. Supports filtering by transaction id, reward id and creation date. operationId: listMemberRewardPurchases parameters: - name: programId in: path required: true description: > Unique loyalty program identifier (format: `lprg_` followed by hexadecimal characters). schema: type: string - name: memberId in: path required: true description: Program member ID (format `lmbr_[a-f0-9]+`). schema: type: string pattern: ^lmbr_[a-f0-9]+$ - name: limit in: query required: false description: > Maximum number of items to return. An integer between 1 and 100; numeric strings are also accepted. Defaults to 10. schema: type: - integer - 'null' minimum: 1 maximum: 100 default: 10 - name: order in: query required: false description: > Sort order. A field name, optionally prefixed with `-` for descending order. May be provided multiple times (array). The same field cannot be used in both ascending and descending order at once. Default: `-created_at`. schema: oneOf: - type: array items: type: string enum: - '-created_at' - created_at - type: string enum: - '-created_at' - created_at - type: 'null' - name: cursor in: query required: false description: > Pagination cursor returned in the `cursor.next` field of a previous response (format: `lcrstrx_` followed by hexadecimal characters). schema: type: - string - 'null' pattern: ^lcrstrx_[a-f0-9]+$ - name: filters in: query required: false style: deepObject explode: true description: > Field filters, e.g. `filters[reward_id][conditions][$is]=lrew_...`. Each field accepts a `conditions` object with condition operators. schema: $ref: '#/components/schemas/RewardPurchaseListFilters' responses: '200': description: Paginated list of reward purchase transactions. content: application/json: schema: $ref: '#/components/schemas/RewardPurchaseListResponse' '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: RewardPurchaseListFilters: type: object description: | Filters for listing reward purchases. properties: junction: description: >- Logical junction between the field filters. Defaults to AND behavior. oneOf: - type: string enum: - AND - OR - type: 'null' id: description: | Filter by reward transaction id. oneOf: - $ref: '#/components/schemas/RewardPurchaseFilterIdConditions' - type: 'null' reward_id: description: | Filter by reward id. oneOf: - $ref: '#/components/schemas/RewardPurchaseFilterRewardIdConditions' - type: 'null' created_at: description: | Filter by creation date. oneOf: - $ref: '#/components/schemas/RewardPurchaseFilterDateConditions' - type: 'null' additionalProperties: false RewardPurchaseListResponse: type: object description: | Paginated list of reward purchase transactions. properties: data: type: array description: Reward purchase transactions (type `PURCHASE` only). items: $ref: '#/components/schemas/RewardPurchaseTransaction' cursor: description: | Pagination cursor. `null` when there are no more results. oneOf: - type: object properties: next: type: string description: > Cursor to pass as the `cursor` query parameter to fetch the next page (format `lcrstrx_...`). expires_at: type: string format: date-time description: Timestamp when the cursor expires. - type: 'null' object: type: string const: list description: Object type marker. Always `list`. 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. RewardPurchaseFilterIdConditions: type: object description: > ID filter conditions for reward transaction ids. Values must match pattern `^lrtx_[a-f0-9]+$`. `$is`/`$is_not` accept a single value (string or 1-element array); `$in`/`$not_in` accept a string or an array of 1-100 values. properties: conditions: type: object minProperties: 1 additionalProperties: false properties: $is: description: Matches transactions whose id equals the given value. oneOf: - type: string pattern: ^lrtx_[a-f0-9]+$ - type: array items: type: string pattern: ^lrtx_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $is_not: description: Matches transactions whose id does not equal the given value. oneOf: - type: string pattern: ^lrtx_[a-f0-9]+$ - type: array items: type: string pattern: ^lrtx_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $in: description: Matches transactions whose id is one of the given values. oneOf: - type: string pattern: ^lrtx_[a-f0-9]+$ - type: array items: type: string pattern: ^lrtx_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' $not_in: description: Matches transactions whose id is not one of the given values. oneOf: - type: string pattern: ^lrtx_[a-f0-9]+$ - type: array items: type: string pattern: ^lrtx_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' required: - conditions additionalProperties: false RewardPurchaseFilterRewardIdConditions: type: object description: > ID filter conditions for reward ids. Values must match pattern `^lrew_[a-f0-9]+$`. `$is`/`$is_not` accept a single value (string or 1-element array); `$in`/`$not_in` accept a string or an array of 1-100 values. properties: conditions: type: object minProperties: 1 additionalProperties: false properties: $is: description: Matches transactions whose reward id equals the given value. oneOf: - type: string pattern: ^lrew_[a-f0-9]+$ - type: array items: type: string pattern: ^lrew_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $is_not: description: >- Matches transactions whose reward id does not equal the given value. oneOf: - type: string pattern: ^lrew_[a-f0-9]+$ - type: array items: type: string pattern: ^lrew_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $in: description: Matches transactions whose reward id is one of the given values. oneOf: - type: string pattern: ^lrew_[a-f0-9]+$ - type: array items: type: string pattern: ^lrew_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' $not_in: description: >- Matches transactions whose reward id is not one of the given values. oneOf: - type: string pattern: ^lrew_[a-f0-9]+$ - type: array items: type: string pattern: ^lrew_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' required: - conditions additionalProperties: false RewardPurchaseFilterDateConditions: $ref: '#/components/schemas/OrderPaymentFilterDateConditions' RewardPurchaseTransaction: type: object description: | A reward transaction. Represents a reward purchase or a reward refund. properties: id: type: string description: > Unique reward transaction identifier (format `lrtx_...`). Absent for DRY_RUN (SIMULATED) transactions, which are never persisted. card_id: type: string description: >- Identifier of the loyalty card the points were spent from (format `lcrd_...`). card_transaction_id: type: - string - 'null' description: > Identifier of the underlying card transaction (format `lctx_...`). `null` for DRY_RUN (SIMULATED) transactions. program_id: type: string description: Identifier of the loyalty program (format `lprg_...`). member_id: type: string description: Identifier of the program member (format `lmbr_...`). reward_id: type: string description: Identifier of the purchased reward (format `lrew_...`). status: type: string enum: - PENDING - PROCESSING - APPROVED - REJECTED - SIMULATED - REFUNDED description: > Transaction status. `PENDING` — created, awaiting processing; `PROCESSING` — being processed; `APPROVED` — completed successfully; `REJECTED` — rejected (see `details.rejection`); `SIMULATED` — dry-run result, not persisted; `REFUNDED` — purchase has been refunded. type: type: string enum: - PURCHASE - REFUND description: Transaction type. details: description: > Transaction details. Shape depends on `type` — purchase details for `PURCHASE`, refund details for `REFUND`. oneOf: - $ref: '#/components/schemas/RewardPurchaseTransactionDetailsPurchase' - $ref: '#/components/schemas/RewardPurchaseTransactionDetailsRefund' - type: 'null' created_at: type: string format: date-time description: Timestamp when the transaction was created (ISO 8601). updated_at: type: - string - 'null' format: date-time description: >- Timestamp when the transaction was last updated (ISO 8601), or `null`. object: type: string const: reward_transaction description: Object type marker. Always `reward_transaction`. OrderPaymentFilterDateConditions: type: object description: > Date filter conditions. `$before`/`$after` accept an ISO date-time string. `$is`/`$more_than`/`$less_than` accept a non-negative integer number of days ago. `$has_value`/`$is_unknown` accept any single value and match rows where the field is set / not set. Single values may also be passed as 1-element arrays. properties: conditions: type: object minProperties: 1 additionalProperties: false properties: $before: description: Matches rows with the date before the given date-time. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $after: description: Matches rows with the date after the given date-time. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $is: description: Matches rows with the date exactly the given number of days ago. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $more_than: description: >- Matches rows with the date more than the given number of days ago. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $less_than: description: >- Matches rows with the date less than the given number of days ago. oneOf: - type: string - type: array items: type: string minItems: 1 maxItems: 1 - type: 'null' $has_value: description: Matches rows where the date field is set. oneOf: - type: string - type: array maxItems: 1 - type: 'null' $is_unknown: description: Matches rows where the date field is not set. oneOf: - type: string - type: array maxItems: 1 - type: 'null' required: - conditions additionalProperties: false RewardPurchaseTransactionDetailsPurchase: type: object description: | Details of a PURCHASE reward transaction. properties: reason: type: string description: 'Human-readable reason. For purchases: "Points spent on reward".' rejection: description: Rejection details, present when the transaction was rejected. oneOf: - $ref: '#/components/schemas/RewardPurchaseRejection' - type: 'null' metadata: type: object description: Transaction metadata. Empty object when not set. additionalProperties: true points: description: Points spent on the purchase. oneOf: - $ref: '#/components/schemas/RewardPurchasePoints' - type: 'null' result: description: > Fulfillment result, populated once the purchase is processed (APPROVED). `null` for PENDING/SIMULATED transactions. oneOf: - $ref: '#/components/schemas/RewardPurchaseResult' - type: 'null' RewardPurchaseTransactionDetailsRefund: type: object description: | Details of a REFUND reward transaction. properties: reason: type: string description: >- Human-readable reason, e.g. "Reward refund — point purchase reversed". rejection: description: Rejection details, present when the transaction was rejected. oneOf: - $ref: '#/components/schemas/RewardPurchaseRejection' - type: 'null' metadata: type: object description: Transaction metadata. Empty object when not set. additionalProperties: true points: description: Points returned by the refund. oneOf: - $ref: '#/components/schemas/RewardPurchasePoints' - type: 'null' result: description: Refunded reward result (what was reverted). oneOf: - $ref: '#/components/schemas/RewardPurchaseResult' - type: 'null' purchase: description: References to the refunded purchase transactions. oneOf: - $ref: '#/components/schemas/RewardPurchaseRefundPurchaseReference' - type: 'null' RewardPurchaseRejection: type: object description: Rejection details. properties: reason: type: string description: Machine-readable rejection reason. details: type: string description: Additional human-readable details about the rejection. RewardPurchasePoints: type: object description: Points involved in the transaction. properties: total: type: number description: Total number of points. RewardPurchaseResult: type: object description: > Reward fulfillment result. Contains the fulfilled reward reference, quantity and the material or digital fulfillment payload. properties: reward: description: Reference to the fulfilled reward. oneOf: - $ref: '#/components/schemas/RewardPurchaseResultReward' - type: 'null' quantity: type: - number - 'null' description: Fulfilled quantity. material: description: Material reward fulfillment payload. Present for MATERIAL rewards. oneOf: - $ref: '#/components/schemas/RewardPurchaseResultMaterial' - type: 'null' digital: description: Digital reward fulfillment payload. Present for DIGITAL rewards. oneOf: - $ref: '#/components/schemas/RewardPurchaseResultDigital' - type: 'null' RewardPurchaseRefundPurchaseReference: type: object description: References to the original purchase transactions being refunded. properties: card_transaction: description: Reference to the original card transaction. oneOf: - type: object properties: id: type: string description: Card transaction identifier (format `lctx_...`). - type: 'null' reward_transaction: description: Reference to the original reward transaction. oneOf: - type: object properties: id: type: string description: Reward transaction identifier (format `lrtx_...`). - type: 'null' RewardPurchaseResultReward: type: object description: Reference to the fulfilled reward. properties: id: type: string description: Reward identifier (format `lrew_...`). type: type: string enum: - MATERIAL - DIGITAL description: Reward type. RewardPurchaseResultMaterial: type: object description: Material reward fulfillment. properties: type: type: string enum: - PRODUCT - SKU description: Material reward type. product: type: object description: Product payload (present when `type` is `PRODUCT`). additionalProperties: true sku: type: object description: SKU payload (present when `type` is `SKU`). additionalProperties: true RewardPurchaseResultDigital: type: object description: Digital reward fulfillment. properties: type: type: string enum: - DISCOUNT_COUPONS - GIFT_VOUCHERS - LOYALTY_CARD_POINTS description: Digital reward type. discount_coupons: type: array description: >- Fulfilled discount coupons (present when `type` is `DISCOUNT_COUPONS`). items: $ref: '#/components/schemas/RewardPurchaseDigitalCoupon' gift_vouchers: type: array description: Fulfilled gift vouchers (present when `type` is `GIFT_VOUCHERS`). items: $ref: '#/components/schemas/RewardPurchaseDigitalGiftVoucher' loyalty_card_points: description: > Fulfilled loyalty card points (present when `type` is `LOYALTY_CARD_POINTS`). oneOf: - $ref: '#/components/schemas/RewardPurchaseDigitalLoyaltyCardPoints' - type: 'null' RewardPurchaseDigitalCoupon: type: object description: Discount coupon fulfillment entry. properties: id: type: string description: Voucher identifier of the coupon. code: type: string description: Coupon code. result: type: string enum: - SKIPPED - DELETED - CREDITS_SUBTRACTED description: > Refund handling result for this coupon (present in refund results): `DELETED` — the coupon was deleted; `SKIPPED` — the coupon was left intact. RewardPurchaseDigitalGiftVoucher: type: object description: Gift voucher fulfillment entry. properties: id: type: string description: Voucher identifier of the gift voucher. code: type: string description: Gift voucher code. amount: type: number description: >- Amount added to (or, for refunds, subtracted from) the gift voucher balance. balance: type: number description: Gift voucher balance after the operation. result: type: string enum: - SKIPPED - DELETED - CREDITS_SUBTRACTED description: > Refund handling result for this gift voucher (present in refund results): `CREDITS_SUBTRACTED` — the credited balance was subtracted; `SKIPPED` — the voucher was left intact. RewardPurchaseDigitalLoyaltyCardPoints: type: object description: | Loyalty card points fulfillment entry. properties: points: type: number description: Number of points credited to the target loyalty card. card_definition_id: type: string description: Target card definition identifier (format `lcdef_...`). card_id: type: string description: Target loyalty card identifier (format `lcrd_...`). 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 ````