v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB

Programs

Get a program member

<Badge color="yellow">BETA endpoint</Badge>

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.

</Warning>

Returns a single member of the program together with all its loyalty cards. Each card includes the current balance, lifetime bucket counters, and next expiration/activation info.

Card code may be null shortly after member creation because card code generation is asynchronous.

Returns 404 when the program or member does not exist.

get/v2/loyalties/programs/{programId}/members/{memberId}

Path parameters

programIdstring required

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

memberIdstring required

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

Response

The member with its cards.

idstring required

Unique member ID assigned by Voucherify.

customer_idstring required

Unique Voucherify ID of the customer enrolled as this member.

program_idstring required

Unique Voucherify ID of the loyalty program the member belongs to.

status'ACTIVE' | 'INACTIVE' | 'DELETED' required

Current member status. INACTIVE member can't earn points or redeem rewards.

metadataobject required

Free-form metadata attached to the member (empty object when none).

created_atstring date-time required

Timestamp when the member was created (ISO 8601).

updated_atstring date-time nullable required

Timestamp when the member was last updated (ISO 8601), or null if never updated.

object'member' required

Object type marker, always member.