List member tier transactions

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>'

{
  "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"
}

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

loyalties

programs

{programId}

members

{memberId}

tiers

transactions

List member tier transactions

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>'

{
  "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

string

header

required

X-App-Token

string

header

required

Path Parameters

programId

string

required

Identifies the loyalty program. Format lprg_[a-f0-9]+.

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

memberId

string

required

Identifies the member. Format lmbr_[a-f0-9]+.

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

Query Parameters

limit

integer | null

default:10

Limits the page size to an integer from 1 to 100. Defaults to 10. A numeric string is accepted and rounded to the nearest integer.

Required range: 1 <= x <= 100

order

Orders the results. Accepts one value or an array. Prefix a field with - for descending order. Defaults to -id. Newest first. The same field cannot be used in both directions.

Available options:

-id,

id

cursor

string | null

Continues pagination. Pass the cursor.next value from a previous response. Format lcrsttx_[a-f0-9]+. The cursor matches the filters and order of that response.

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

filters

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

Filters the results. Pass a deep object, for example filters[card_id][conditions][$is]=lcrd_.... Fields combine through junction, which defaults to AND. Omit filters to apply no field filter. Request query schema for GET /v2/loyalties/programs/{programId}/members/{memberId}/tiers/transactions.

Show child attributes

Response

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"

Introduction

Endpoints

Events

List member tier transactions

Authorizations

Path Parameters

Query Parameters

Response