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 /v2/loyalties/memberships/{customerId}

Get customer memberships

cURL

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

200

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

Authorizations

X-App-Id & X-App-TokenbearerAuth

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

200

application/json

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"