Get program member

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

{
  "id": "lmbr_128f962dbc8c4ba5dc",
  "customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
  "program_id": "lprg_128f58429f4c4bf7b2",
  "status": "ACTIVE",
  "metadata": {},
  "created_at": "2026-06-11T15:59:41.298Z",
  "updated_at": null,
  "object": "member",
  "cards": [
    {
      "member_role": "OWNER",
      "created_at": "2026-06-11T15:59:41.303Z",
      "card": {
        "id": "lcrd_128f962dbd8c4ba5df",
        "card_definition_id": "lcdef_128f495f720c4bec8c",
        "card_type": "INDIVIDUAL",
        "code": "SummerTime-7z8dWawICd",
        "lifetime_bucket": {
          "points": {
            "total": 740,
            "earned": 40,
            "added": 700,
            "purchased": 0,
            "purchased_reversed": 0,
            "subtracted": 30,
            "expired": 300,
            "spent": 250,
            "refunded": 0,
            "returned": 0,
            "locked": 250,
            "unlocked": 250
          },
          "pending_points": {
            "total": 160,
            "activated": 40,
            "canceled": 0
          }
        },
        "balance": {
          "points": 160,
          "pending_points": 120
        },
        "next_expiration": {
          "points": 160,
          "date": "2026-08-08"
        },
        "next_activation": {
          "points": 10,
          "type": "PERIOD_BASED",
          "date": "2026-07-20"
        },
        "object": "card"
      },
      "object": "member_card"
    },
    {
      "member_role": "OWNER",
      "created_at": "2026-06-11T15:59:41.303Z",
      "card": {
        "id": "lcrd_128f962dbd8c4ba5e0",
        "card_definition_id": "lcdef_128f49963c0c4becb7",
        "card_type": "INDIVIDUAL",
        "code": "AutumnTime-R02hVARx33",
        "lifetime_bucket": {
          "points": {
            "total": 50,
            "earned": 0,
            "added": 50,
            "purchased": 0,
            "purchased_reversed": 0,
            "subtracted": 0,
            "expired": 0,
            "spent": 0,
            "refunded": 0,
            "returned": 0,
            "locked": 0,
            "unlocked": 0
          },
          "pending_points": {
            "total": 160,
            "activated": 0,
            "canceled": 0
          }
        },
        "balance": {
          "points": 50,
          "pending_points": 160
        },
        "next_expiration": {
          "points": 50,
          "date": "2026-12-23"
        },
        "next_activation": {
          "points": 160,
          "type": "FIXED_DATES",
          "date": "2026-12-23"
        },
        "object": "card"
      },
      "object": "member_card"
    },
    {
      "member_role": "OWNER",
      "created_at": "2026-06-11T15:59:41.303Z",
      "card": {
        "id": "lcrd_128f962dbd8c4ba5e1",
        "card_definition_id": "lcdef_128f4a88414c4bed69",
        "card_type": "INDIVIDUAL",
        "code": "AnnualTime-7M7ShPGfme",
        "lifetime_bucket": {
          "points": {
            "total": 1250,
            "earned": 250,
            "added": 1000,
            "purchased": 0,
            "purchased_reversed": 0,
            "subtracted": 1000,
            "expired": 0,
            "spent": 150,
            "refunded": 0,
            "returned": 0,
            "locked": 10,
            "unlocked": 10
          },
          "pending_points": {
            "total": 300,
            "activated": 250,
            "canceled": 0
          }
        },
        "balance": {
          "points": 100,
          "pending_points": 50
        },
        "next_expiration": null,
        "next_activation": {
          "points": 50,
          "type": "PERIOD_BASED",
          "date": "2026-07-20"
        },
        "object": "card"
      },
      "object": "member_card"
    }
  ]
}

Get program member

Returns one member of the program together with that member’s loyalty cards. Each card includes balance, lifetime_bucket, next_expiration, and next_activation. tier_progress is not included. Use Get program membership when you need tier progress.

card.code can be null shortly after member creation, while code generation is still running.

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

GET

loyalties

programs

{programId}

members

{memberId}

Get program member

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

{
  "id": "lmbr_128f962dbc8c4ba5dc",
  "customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
  "program_id": "lprg_128f58429f4c4bf7b2",
  "status": "ACTIVE",
  "metadata": {},
  "created_at": "2026-06-11T15:59:41.298Z",
  "updated_at": null,
  "object": "member",
  "cards": [
    {
      "member_role": "OWNER",
      "created_at": "2026-06-11T15:59:41.303Z",
      "card": {
        "id": "lcrd_128f962dbd8c4ba5df",
        "card_definition_id": "lcdef_128f495f720c4bec8c",
        "card_type": "INDIVIDUAL",
        "code": "SummerTime-7z8dWawICd",
        "lifetime_bucket": {
          "points": {
            "total": 740,
            "earned": 40,
            "added": 700,
            "purchased": 0,
            "purchased_reversed": 0,
            "subtracted": 30,
            "expired": 300,
            "spent": 250,
            "refunded": 0,
            "returned": 0,
            "locked": 250,
            "unlocked": 250
          },
          "pending_points": {
            "total": 160,
            "activated": 40,
            "canceled": 0
          }
        },
        "balance": {
          "points": 160,
          "pending_points": 120
        },
        "next_expiration": {
          "points": 160,
          "date": "2026-08-08"
        },
        "next_activation": {
          "points": 10,
          "type": "PERIOD_BASED",
          "date": "2026-07-20"
        },
        "object": "card"
      },
      "object": "member_card"
    },
    {
      "member_role": "OWNER",
      "created_at": "2026-06-11T15:59:41.303Z",
      "card": {
        "id": "lcrd_128f962dbd8c4ba5e0",
        "card_definition_id": "lcdef_128f49963c0c4becb7",
        "card_type": "INDIVIDUAL",
        "code": "AutumnTime-R02hVARx33",
        "lifetime_bucket": {
          "points": {
            "total": 50,
            "earned": 0,
            "added": 50,
            "purchased": 0,
            "purchased_reversed": 0,
            "subtracted": 0,
            "expired": 0,
            "spent": 0,
            "refunded": 0,
            "returned": 0,
            "locked": 0,
            "unlocked": 0
          },
          "pending_points": {
            "total": 160,
            "activated": 0,
            "canceled": 0
          }
        },
        "balance": {
          "points": 50,
          "pending_points": 160
        },
        "next_expiration": {
          "points": 50,
          "date": "2026-12-23"
        },
        "next_activation": {
          "points": 160,
          "type": "FIXED_DATES",
          "date": "2026-12-23"
        },
        "object": "card"
      },
      "object": "member_card"
    },
    {
      "member_role": "OWNER",
      "created_at": "2026-06-11T15:59:41.303Z",
      "card": {
        "id": "lcrd_128f962dbd8c4ba5e1",
        "card_definition_id": "lcdef_128f4a88414c4bed69",
        "card_type": "INDIVIDUAL",
        "code": "AnnualTime-7M7ShPGfme",
        "lifetime_bucket": {
          "points": {
            "total": 1250,
            "earned": 250,
            "added": 1000,
            "purchased": 0,
            "purchased_reversed": 0,
            "subtracted": 1000,
            "expired": 0,
            "spent": 150,
            "refunded": 0,
            "returned": 0,
            "locked": 10,
            "unlocked": 10
          },
          "pending_points": {
            "total": 300,
            "activated": 250,
            "canceled": 0
          }
        },
        "balance": {
          "points": 100,
          "pending_points": 50
        },
        "next_expiration": null,
        "next_activation": {
          "points": 50,
          "type": "PERIOD_BASED",
          "date": "2026-07-20"
        },
        "object": "card"
      },
      "object": "member_card"
    }
  ]
}

Authorizations

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]+$

Response

The member with its cards.

A loyalty program member together with its loyalty cards. Returned by member create and get endpoints.

string

required

Identifies the member.

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

customer_id

string

required

Identifies the enrolled customer.

Pattern: ^cust_[a-zA-Z0-9]+

program_id

string

required

Identifies the loyalty program.

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

status

enum<string>

required

Current member status. Allowed values: ACTIVE, INACTIVE, DELETED. INACTIVE members cannot earn points or redeem rewards.

Available options:

ACTIVE,

INACTIVE,

DELETED

metadata

object

required

Stores custom member metadata. Empty object when none is set.

created_at

string<date-time>

required

Records when the member was created (ISO 8601).

updated_at

string<date-time> | null

required

Records the last update (ISO 8601). null if the member has never been updated.

object

string

required

Object type. Always member.

Allowed value: "member"

cards

object[]

required

Member's loyalty cards - one per card definition assigned to the program. Card codes are generated asynchronously, so card.code may be null right after member creation.

Show child attributes

Last modified on October 9, 2026

Introduction

Endpoints

Events

Get program member

Authorizations

Path Parameters

Response