List member reward purchases

curl --request GET \
  --url {protocol}://{host}/v2/loyalties/programs/{programId}/members/{memberId}/rewards/purchases \
  --header 'Authorization: Bearer <token>' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "card_id": "<string>",
      "card_transaction_id": "<string>",
      "program_id": "<string>",
      "member_id": "<string>",
      "reward_id": "<string>",
      "details": {
        "reason": "<string>",
        "rejection": {
          "reason": "<string>",
          "details": "<string>"
        },
        "metadata": {},
        "points": {
          "total": 123
        },
        "result": {
          "reward": {
            "id": "<string>"
          },
          "quantity": 123,
          "material": {
            "product": {},
            "sku": {}
          },
          "digital": {
            "discount_coupons": [
              {
                "id": "<string>",
                "code": "<string>"
              }
            ],
            "gift_vouchers": [
              {
                "id": "<string>",
                "code": "<string>",
                "amount": 123,
                "balance": 123
              }
            ],
            "loyalty_card_points": {
              "points": 123,
              "card_definition_id": "<string>",
              "card_id": "<string>"
            }
          }
        }
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

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.

GET

loyalties

programs

{programId}

members

{memberId}

rewards

purchases

Error

A valid request URL is required to generate request examples

{
  "data": [
    {
      "id": "<string>",
      "card_id": "<string>",
      "card_transaction_id": "<string>",
      "program_id": "<string>",
      "member_id": "<string>",
      "reward_id": "<string>",
      "details": {
        "reason": "<string>",
        "rejection": {
          "reason": "<string>",
          "details": "<string>"
        },
        "metadata": {},
        "points": {
          "total": 123
        },
        "result": {
          "reward": {
            "id": "<string>"
          },
          "quantity": 123,
          "material": {
            "product": {},
            "sku": {}
          },
          "digital": {
            "discount_coupons": [
              {
                "id": "<string>",
                "code": "<string>"
              }
            ],
            "gift_vouchers": [
              {
                "id": "<string>",
                "code": "<string>",
                "amount": 123,
                "balance": 123
              }
            ],
            "loyalty_card_points": {
              "points": 123,
              "card_definition_id": "<string>",
              "card_id": "<string>"
            }
          }
        }
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "object": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id

string

header

required

X-App-Token

string

header

required

Path Parameters

programId

string

required

Unique loyalty program identifier (format: lprg_ followed by hexadecimal characters).

memberId

string

required

Program member ID (format lmbr_[a-f0-9]+).

Pattern: ^lmbr_[a-f0-9]+$

Query Parameters

limit

integer | null

default:10

Maximum number of items to return. An integer between 1 and 100; numeric strings are also accepted. Defaults to 10.

Required range: 1 <= x <= 100

order

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.

Available options:

-created_at,

created_at

cursor

string | null

Pagination cursor returned in the cursor.next field of a previous response (format: lcrstrx_ followed by hexadecimal characters).

Pattern: ^lcrstrx_[a-f0-9]+$

filters

object

Field filters, e.g. filters[reward_id][conditions][$is]=lrew_.... Each field accepts a conditions object with condition operators.

Filters for listing reward purchases.

Show child attributes

Response

Paginated list of reward purchase transactions.

data

object[]

Reward purchase transactions (type PURCHASE only).

Show child attributes

cursor

object | null

Pagination cursor. null when there are no more results.

Show child attributes

object

string

Object type marker. Always list.

Allowed value: "list"

Last modified on July 9, 2026

Get card daily points report Purchase a reward with points

⌘I