Get customer memberships

curl --request GET \
  --url {protocol}://{host}/v2/loyalties/memberships/{customerId} \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

{
  "customer": {
    "id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
    "source_id": "source-123",
    "object": "customer"
  },
  "memberships": [
    {
      "member": {
        "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"
      },
      "program": {
        "id": "lprg_128f58429f4c4bf7b2",
        "name": "VIP Program",
        "status": "ACTIVE",
        "metadata": {},
        "object": "program"
      },
      "cards": [
        {
          "member_role": "OWNER",
          "created_at": "2026-06-11T15:59:41.298Z",
          "card": {
            "id": "lcard_128f962dbc8c4ba5dc",
            "card_definition_id": "lcdef_128f58429f4c4bf7b2",
            "card_type": "INDIVIDUAL",
            "code": "CARD-001",
            "object": "card"
          },
          "object": "member_card"
        }
      ],
      "object": "membership"
    }
  ],
  "object": "memberships_result"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

Get customer memberships

Documentation in progress

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact Voucherify support or your Technical Account Manager.

Returns all loyalty memberships for a customer across programs, including the resolved customer identity and each membership’s member, program, and cards. Use identification_type to choose how the customerId path value is interpreted.

Returns an empty memberships array when the customer exists but has no memberships. Returns 404 when the customer or member cannot be resolved.

GET

loyalties

memberships

{customerId}

Error

A valid request URL is required to generate request examples

{
  "customer": {
    "id": "cust_6onRrs4kCnvSVrTs5YtDPFBG",
    "source_id": "source-123",
    "object": "customer"
  },
  "memberships": [
    {
      "member": {
        "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"
      },
      "program": {
        "id": "lprg_128f58429f4c4bf7b2",
        "name": "VIP Program",
        "status": "ACTIVE",
        "metadata": {},
        "object": "program"
      },
      "cards": [
        {
          "member_role": "OWNER",
          "created_at": "2026-06-11T15:59:41.298Z",
          "card": {
            "id": "lcard_128f962dbc8c4ba5dc",
            "card_definition_id": "lcdef_128f58429f4c4bf7b2",
            "card_type": "INDIVIDUAL",
            "code": "CARD-001",
            "object": "card"
          },
          "object": "member_card"
        }
      ],
      "object": "membership"
    }
  ],
  "object": "memberships_result"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

Authorizations

X-App-Id

string

header

required

X-App-Token

string

header

required

Path Parameters

customerId

string

required

Unique identifier of the customer or member, interpreted according to identification_type: a Voucherify customer ID (cust_...), a customer source_id, or a loyalty member ID (lmbr_...).

Query Parameters

identification_type

enum<string>

default:customer_id

Defines how the customerId path value is interpreted. customer_id - Voucherify customer ID (default). customer_source_id - customer's source_id. member_id - loyalty member ID.

Available options:

customer_id,

customer_source_id,

member_id

Response

Customer memberships across programs.

Cross-program memberships result for a customer.

customer

object

required

Resolved customer identity.

Show child attributes

memberships

object[]

required

Memberships across all loyalty programs the customer belongs to. Empty when the customer has no memberships.

Show child attributes

object

string

required

Object type marker. Always memberships_result.

Allowed value: "memberships_result"

Last modified on August 3, 2026

⌘I

Introduction

Endpoints

Events

Get customer memberships

Authorizations

Path Parameters

Query Parameters

Response