From 9938c318d4534265cca1c2541f2550d8ef359cfa Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 15 Jun 2026 07:10:14 +0000 Subject: [PATCH] docs: clarify loyalty point transaction history endpoints --- documentation/build/loyalty-points.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/documentation/build/loyalty-points.mdx b/documentation/build/loyalty-points.mdx index 3686db5c3..84510218b 100644 --- a/documentation/build/loyalty-points.mdx +++ b/documentation/build/loyalty-points.mdx @@ -88,6 +88,21 @@ When you transfer points from one card to another, the expiration date is reset However, you can't transfer expired or pending points. +### Loyalty point transaction history + +You can retrieve the full point transaction history for a customer's loyalty card using the Loyalties API. The response includes all point movements such as `POINTS_ACCRUAL`, `POINTS_REDEMPTION`, `POINTS_REFUND`, `POINTS_ADDITION`, `POINTS_REMOVAL`, `POINTS_EXPIRATION`, and `POINTS_TRANSFER`. + +| Endpoint | Use when | +|---|---| +| [`GET /v1/loyalties/members/{memberId}/transactions`](/api-reference/loyalties/list-loyalty-card-transactions) | You want all point movements for a specific loyalty card without filtering by campaign. `memberId` is the loyalty card code. | +| [`GET /v1/loyalties/{campaignId}/members/{memberId}/transactions`](/api-reference/loyalties/list-loyalty-card-transactions-with-campaign-id) | You want point movements scoped to a specific loyalty campaign. | + +A customer can hold loyalty cards in more than one loyalty campaign. The `loyalty_cards` array on the customer object lists every card code the customer holds, so call the endpoint above once per `memberId` to compile the customer's full points history across programs. + + + The [List Voucher Transactions](/api-reference/vouchers/list-voucher-transactions) endpoint (`GET /v1/vouchers/{code}/transactions`) is a generic, voucher-centric endpoint that returns credit movements for any gift card or loyalty card by code. For points history specifically, the Loyalties endpoints above are recommended because they return point-specific transaction types and support advanced `filters`. + + ## Pending points Pending points are points that have been earned by a customer, but are not yet available for redemption. This status is used to create a mandatory waiting period for points to ensure validity, account for potential returns, or synchronize with external systems.