List member tier transactions

Lists tier transactions for the member: joins, leaves, upgrades, downgrades, expiration changes, and evaluation refreshes. Results use cursor pagination. Default order is -id, newest first.

Filters are card_id, card_definition_id, and created_at.

Returns 404 when the program doesn’t exist, or when the member doesn’t exist in that program. The program is checked first. A DELETED member returns 404.

Returns 400 with key invalid_query_params when the query fails validation. That check runs before the program and member lookup. order must be id or -id. An array that orders by both directions is rejected. A cursor that doesn’t match ^lcrsttx_[a-f0-9]+$ fails here.

After the program and member are found, an unknown or expired cursor returns invalid_or_expired_cursor. A cursor recorded for different filters or order returns cursor_and_query_mismatch. The cursor stays valid when only limit changes.

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

List member tier transactions

cURL

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

200

Tier transaction list

{
  "data": [
    {
      "id": "lttx_12fa3c024b476799e1",
      "card_id": "lcrd_128f962dbd8c4ba5e1",
      "program_id": "lprg_128f58429f4c4bf7b2",
      "member_id": "lmbr_128f962dbc8c4ba5dc",
      "card_definition_id": "lcdef_128f4a88414c4bed69",
      "tier_structure_id": "lts_128f4b460e4c4bedf6",
      "tier_id": "lt_128f4b46808c4bee07",
      "type": "UPGRADED",
      "details": {
        "points": 500,
        "tier_from": "lt_128f4b46400c4bedfb",
        "tier_to": "lt_128f4b46808c4bee07",
        "origin": {
          "type": "card_operations",
          "card_transaction_ids": [
            "lctx_12fa3c0169a025a387"
          ]
        },
        "rejection": null,
        "start_at": null,
        "expires_at": null
      },
      "status": "APPROVED",
      "created_at": "2026-09-02T12:03:12.301Z",
      "updated_at": "2026-09-02T12:03:12.908Z",
      "object": "tier_transaction"
    },
    {
      "id": "lttx_12f7dc870f4fbd500c",
      "card_id": "lcrd_128f962dbd8c4ba5e1",
      "program_id": "lprg_128f58429f4c4bf7b2",
      "member_id": "lmbr_128f962dbc8c4ba5dc",
      "card_definition_id": "lcdef_128f4a88414c4bed69",
      "tier_structure_id": "lts_128f4b460e4c4bedf6",
      "tier_id": "lt_128f4b46400c4bedfb",
      "type": "DOWNGRADED",
      "details": {
        "points": 0,
        "tier_from": "lt_128f4b46808c4bee07",
        "tier_to": "lt_128f4b46400c4bedfb",
        "origin": {
          "type": "card_operations",
          "card_transaction_ids": [
            "lctx_12f7dc8650267658b4"
          ]
        },
        "rejection": null,
        "start_at": null,
        "expires_at": null
      },
      "status": "APPROVED",
      "created_at": "2026-08-31T15:49:04.701Z",
      "updated_at": "2026-08-31T15:49:05.673Z",
      "object": "tier_transaction"
    },
    {
      "id": "lttx_12f3b6e3a268738b18",
      "card_id": "lcrd_128f962dbd8c4ba5e1",
      "program_id": "lprg_128f58429f4c4bf7b2",
      "member_id": "lmbr_128f962dbc8c4ba5dc",
      "card_definition_id": "lcdef_128f4a88414c4bed69",
      "tier_structure_id": "lts_128f4b460e4c4bedf6",
      "tier_id": null,
      "type": "EVALUATION_REFRESHED",
      "details": {
        "points": 2221000,
        "tier_from": null,
        "tier_to": null,
        "origin": {
          "type": "card_operations",
          "card_transaction_ids": [
            "lctx_12f3b6e28cae8bfa27"
          ]
        },
        "rejection": null,
        "start_at": null,
        "expires_at": null
      },
      "status": "APPROVED",
      "created_at": "2026-08-28T10:30:42.569Z",
      "updated_at": "2026-08-28T10:30:43.406Z",
      "object": "tier_transaction"
    },
    {
      "id": "lttx_1294dc734a1bbeb5ec",
      "card_id": "lcrd_128f962dbd8c4ba5e1",
      "program_id": "lprg_128f58429f4c4bf7b2",
      "member_id": "lmbr_128f962dbc8c4ba5dc",
      "card_definition_id": "lcdef_128f4a88414c4bed69",
      "tier_structure_id": "lts_128f4b460e4c4bedf6",
      "tier_id": null,
      "type": "EXPIRATION_CHANGED",
      "details": {
        "points": 500,
        "tier_from": null,
        "tier_to": null,
        "origin": {
          "type": "daily_task_operations"
        },
        "rejection": null,
        "start_at": null,
        "expires_at": "2026-07-15T23:59:59.999Z"
      },
      "status": "APPROVED",
      "created_at": "2026-06-15T18:19:06.920Z",
      "updated_at": "2026-06-15T18:19:07.918Z",
      "object": "tier_transaction"
    },
    {
      "id": "lttx_128f962dbf0c4ba5e5",
      "card_id": "lcrd_128f962dbd8c4ba5e1",
      "program_id": "lprg_128f58429f4c4bf7b2",
      "member_id": "lmbr_128f962dbc8c4ba5dc",
      "card_definition_id": "lcdef_128f4a88414c4bed69",
      "tier_structure_id": "lts_128f4b460e4c4bedf6",
      "tier_id": "lt_128f4b46400c4bedfb",
      "type": "JOINED",
      "details": {
        "points": 0,
        "tier_from": null,
        "tier_to": "lt_128f4b46400c4bedfb",
        "origin": {
          "type": "member_card_created"
        },
        "rejection": null,
        "start_at": null,
        "expires_at": null
      },
      "status": "APPROVED",
      "created_at": "2026-06-11T15:59:41.308Z",
      "updated_at": "2026-06-11T15:59:42.248Z",
      "object": "tier_transaction"
    }
  ],
  "cursor": {
    "next": "lcrsttx_130e8b9d41ee46fb7a",
    "expires_at": "2026-09-18T06:50:37.639Z"
  },
  "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>

Sort field. Allowed values are id and -id. Defaults to -id, newest first, when omitted, null, or an empty array. Accepts one value or an array of those values. An array that contains both directions is rejected.

Available options: -id, id

cursor · string | null

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

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

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

Field filters. card_id, card_definition_id, and created_at. Example: filters[card_id][conditions][$is]=lcrd_.... Request query schema for GET /v2/loyalties/programs/{programId}/members/{memberId}/tiers/transactions.

Show child attributes

Response

200

application/json

Paginated list of tier transactions.

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

data · object[] · required

List of tier transactions.

Show child attributes

cursor · object | null · required

Pagination cursor, or null when there are no more results.

Show child attributes

object · string · required

Object type marker. Always list.

Allowed value: "list"