List member benefit transactions

Lists benefit transactions (benefit fulfillments) for a given program member, with cursor-based pagination.

Supports filtering by benefit ID and creation date.

GET /v2/loyalties/programs/{programId}/members/{memberId}/benefits/transactions

List member benefit transactions

cURL

curl --request GET \
  --url https://{cluster}.voucherify.io/v2/loyalties/programs/{programId}/members/{memberId}/benefits/transactions \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

200

Benefit transaction list

{
  "data": [
    {
      "id": "lbtx_12f8c3d1571aa184e0",
      "benefit_id": "lben_128f4bba81947c8542",
      "program_id": "lprg_128f58429f4c4bf7b2",
      "member_id": "lmbr_128f962dbc8c4ba5dc",
      "earning_rule_id": "lern_128f57ec40cc4bf762",
      "type": "FULFILLMENT",
      "details": {
        "reason": "AnnualProgram / Autumn Ethiopia",
        "rejection": null,
        "metadata": {
          "event_id": "evcus_12f8c3cf15eed6dde4",
          "earning_item_id": "lernei_128f57ec3b8c4bf761"
        },
        "result": {
          "details": {
            "material": {
              "type": "PRODUCT",
              "product": {
                "id": "prod_128f4baa45547c8530"
              }
            }
          }
        }
      },
      "status": "APPROVED",
      "created_at": "2026-09-01T08:39:36.028Z",
      "updated_at": null,
      "object": "benefit_transaction"
    }
  ],
  "cursor": {
    "next": "lcrsbtx_12f8c42751eed6de54",
    "expires_at": "2026-09-01T08:51:04.072Z"
  },
  "object": "list"
}

Authorizations

X-App-Id & X-App-TokenbearerAuth

X-App-Id · string · header · required

X-App-Token · string · header · required

Path Parameters

programId · string · required

Unique loyalty program ID (format lprg_[a-f0-9]+).

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

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 · enum<string>[] enum<string>

Field(s) to order results by. Valid orders are id and -id; defaults to -id (newest first). Ordering by the same field in both directions simultaneously is rejected.

Available options: id, -id

cursor · string | null

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

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

filters · Loyalties Programs Members Benefits Transactions List Request Query · object | null

Field filters, e.g. filters[benefit_id][conditions][$is]=lben_.... Each field accepts a conditions object with condition operators. Request query schema for GET /v2/loyalties/programs/{programId}/members/{memberId}/benefits/transactions.

Show child attributes

Response

200

application/json

Paginated list of benefit transactions.

Response body schema for GET /v2/loyalties/programs/{programId}/members/{memberId}/benefits/transactions.

data · object[] · required

List of benefit transactions.

Show child attributes

cursor · object | null · required

Pagination cursor. null when there are no more results.

Show child attributes

object · string · required

Object type marker. Always list.

Allowed value: "list"