Get customer memberships
curl --request GET \
--url https://{cluster}.voucherify.io/v2/loyalties/memberships/{customerId} \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>'{
"customer": {
"id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"source_id": "lx-rdmptr",
"object": "customer"
},
"memberships": [
{
"member": {
"id": "lmbr_128f962dbc8c4ba5dc",
"customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {
"Lv2Member": "PQR"
},
"created_at": "2026-06-11T15:59:41.298Z",
"updated_at": "2026-09-17T14:02:05.105Z",
"object": "member"
},
"program": {
"id": "lprg_128f58429f4c4bf7b2",
"name": "AnnualProgram",
"status": "ACTIVE",
"metadata": {},
"object": "program"
},
"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": 2701,
"earned": 250,
"added": 2451,
"purchased": 0,
"purchased_reversed": 0,
"subtracted": 33,
"expired": 2158,
"spent": 500,
"refunded": 0,
"returned": 0,
"locked": 500,
"unlocked": 500
},
"pending_points": {
"total": 310,
"activated": 250,
"canceled": 60
}
},
"balance": {
"points": 10,
"pending_points": 0
},
"next_expiration": {
"points": 10,
"date": "2026-11-22"
},
"next_activation": null,
"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": 310,
"activated": 0,
"canceled": 0
}
},
"balance": {
"points": 50,
"pending_points": 310
},
"next_expiration": {
"points": 50,
"date": "2026-12-23"
},
"next_activation": {
"points": 310,
"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": 92925835,
"earned": 2916298,
"added": 90009537,
"purchased": 0,
"purchased_reversed": 0,
"subtracted": 90689052,
"expired": 2227148,
"spent": 9985,
"refunded": 0,
"returned": 500,
"locked": 57613,
"unlocked": 57613
},
"pending_points": {
"total": 2916298,
"activated": 2916298,
"canceled": 0
}
},
"balance": {
"points": 150,
"pending_points": 0
},
"next_expiration": {
"points": 150,
"date": "2026-12-31"
},
"next_activation": null,
"object": "card"
},
"object": "member_card"
}
],
"object": "membership"
},
{
"member": {
"id": "lmbr_12bb65545345af2452",
"customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"program_id": "lprg_12bb64ba895f8d3d38",
"status": "ACTIVE",
"metadata": {},
"created_at": "2026-07-15T16:39:25.773Z",
"updated_at": null,
"object": "member"
},
"program": {
"id": "lprg_12bb64ba895f8d3d38",
"name": "TestujemyLimity",
"status": "ACTIVE",
"metadata": {},
"object": "program"
},
"cards": [
{
"member_role": "OWNER",
"created_at": "2026-07-15T16:39:25.781Z",
"card": {
"id": "lcrd_12bb655454c5af2455",
"card_definition_id": "lcdef_12bb64c52585af2385",
"card_type": "INDIVIDUAL",
"code": "Limity-GeSEtNqPox",
"lifetime_bucket": {
"points": {
"total": 23,
"earned": 23,
"added": 0,
"purchased": 0,
"purchased_reversed": 0,
"subtracted": 10,
"expired": 0,
"spent": 3,
"refunded": 0,
"returned": 0,
"locked": 3,
"unlocked": 3
},
"pending_points": {
"total": 0,
"activated": 0,
"canceled": 0
}
},
"balance": {
"points": 10,
"pending_points": 0
},
"next_expiration": null,
"next_activation": null,
"object": "card"
},
"object": "member_card"
}
],
"object": "membership"
}
],
"object": "memberships_result"
}Get customer memberships
Returns loyalty memberships for a customer, including the resolved customer and each membership’s member, program, and cards. identification_type chooses how customerId is read. It defaults to customer_id.
customer_id and customer_source_id return every membership for that customer. member_id returns the customer linked to that member and only the membership for that member’s program.
Cards omit tier_progress. See Get program membership when you need tier progress.
Returns an empty memberships array when the customer exists and has no memberships. Returns 404 when the customer or member cannot be resolved.
GET
/
v2
/
loyalties
/
memberships
/
{customerId}
Get customer memberships
curl --request GET \
--url https://{cluster}.voucherify.io/v2/loyalties/memberships/{customerId} \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>'{
"customer": {
"id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"source_id": "lx-rdmptr",
"object": "customer"
},
"memberships": [
{
"member": {
"id": "lmbr_128f962dbc8c4ba5dc",
"customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {
"Lv2Member": "PQR"
},
"created_at": "2026-06-11T15:59:41.298Z",
"updated_at": "2026-09-17T14:02:05.105Z",
"object": "member"
},
"program": {
"id": "lprg_128f58429f4c4bf7b2",
"name": "AnnualProgram",
"status": "ACTIVE",
"metadata": {},
"object": "program"
},
"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": 2701,
"earned": 250,
"added": 2451,
"purchased": 0,
"purchased_reversed": 0,
"subtracted": 33,
"expired": 2158,
"spent": 500,
"refunded": 0,
"returned": 0,
"locked": 500,
"unlocked": 500
},
"pending_points": {
"total": 310,
"activated": 250,
"canceled": 60
}
},
"balance": {
"points": 10,
"pending_points": 0
},
"next_expiration": {
"points": 10,
"date": "2026-11-22"
},
"next_activation": null,
"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": 310,
"activated": 0,
"canceled": 0
}
},
"balance": {
"points": 50,
"pending_points": 310
},
"next_expiration": {
"points": 50,
"date": "2026-12-23"
},
"next_activation": {
"points": 310,
"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": 92925835,
"earned": 2916298,
"added": 90009537,
"purchased": 0,
"purchased_reversed": 0,
"subtracted": 90689052,
"expired": 2227148,
"spent": 9985,
"refunded": 0,
"returned": 500,
"locked": 57613,
"unlocked": 57613
},
"pending_points": {
"total": 2916298,
"activated": 2916298,
"canceled": 0
}
},
"balance": {
"points": 150,
"pending_points": 0
},
"next_expiration": {
"points": 150,
"date": "2026-12-31"
},
"next_activation": null,
"object": "card"
},
"object": "member_card"
}
],
"object": "membership"
},
{
"member": {
"id": "lmbr_12bb65545345af2452",
"customer_id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
"program_id": "lprg_12bb64ba895f8d3d38",
"status": "ACTIVE",
"metadata": {},
"created_at": "2026-07-15T16:39:25.773Z",
"updated_at": null,
"object": "member"
},
"program": {
"id": "lprg_12bb64ba895f8d3d38",
"name": "TestujemyLimity",
"status": "ACTIVE",
"metadata": {},
"object": "program"
},
"cards": [
{
"member_role": "OWNER",
"created_at": "2026-07-15T16:39:25.781Z",
"card": {
"id": "lcrd_12bb655454c5af2455",
"card_definition_id": "lcdef_12bb64c52585af2385",
"card_type": "INDIVIDUAL",
"code": "Limity-GeSEtNqPox",
"lifetime_bucket": {
"points": {
"total": 23,
"earned": 23,
"added": 0,
"purchased": 0,
"purchased_reversed": 0,
"subtracted": 10,
"expired": 0,
"spent": 3,
"refunded": 0,
"returned": 0,
"locked": 3,
"unlocked": 3
},
"pending_points": {
"total": 0,
"activated": 0,
"canceled": 0
}
},
"balance": {
"points": 10,
"pending_points": 0
},
"next_expiration": null,
"next_activation": null,
"object": "card"
},
"object": "member_card"
}
],
"object": "membership"
}
],
"object": "memberships_result"
}Authorizations
X-App-Id & X-App-TokenbearerAuth
Path Parameters
Identifies the customer or member. identification_type selects the value: a Voucherify customer ID (cust_...), a customer source_id, or a loyalty member ID (lmbr_...).
Query Parameters
Selects how customerId is read. customer_id is the Voucherify customer ID and the default. customer_source_id is the customer's source_id. member_id is the loyalty member ID.
Available options:
customer_id, customer_source_id, member_id Response
Customer memberships across programs.
Response body schema for GET /v2/loyalties/memberships/{customerId}.
Returns the resolved customer. Present for customer_id, customer_source_id, and member_id.
Show child attributes
Show child attributes
List of memberships. For customer_id and customer_source_id, includes every program the customer belongs to. For member_id, includes only that member's program. Empty when the customer has no memberships.
Show child attributes
Show child attributes
Object type marker. Always memberships_result.
Allowed value:
"memberships_result"