Custom store API / Get a member

Get a member

With members connected, your team sees a customer's tier and sign-up date right in the conversation. This is optional (capabilities members).

Get a member by ID

GET/v1/customers/{member_id}

The response is { "data": Customer }. Return 404 if the member doesn't exist.

Request

curl "https://api.mall.example.com/v1/customers/m_1001" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"

Response — 200 OK

{
  "data": {
    "member_id": "m_1001",
    "name": "K*** S.",
    "cellphone": "010-****-5821",
    "email": "ki***@example.com",
    "group_no": "2",
    "group_name": "VIP",
    "created_date": "2025-06-02T00:00:00+09:00"
  }
}

Find by phone number

GET/v1/customers?cellphone={cellphone}

The response is { "data": [Customer] }. Lillo links the customer only when exactly one member matches.

Customer fields

member_idstringRequired

Member ID

namestringOptional

Name (masked)

cellphonestringOptional

Mobile number (masked, e.g. 010-****-5821)

emailstringOptional

Email (masked, e.g. ki***@example.com)

group_nostringOptional

Member tier number

group_namestringOptional

Extension. Member tier name

created_datestringOptional

Sign-up time

FieldTypeRequiredDescription

member_idstringRequiredMember ID

namestringOptionalName (masked)

cellphonestringOptionalMobile number (masked, e.g. 010-****-5821)

emailstringOptionalEmail (masked, e.g. ki***@example.com)

group_nostringOptionalMember tier number

group_namestringOptionalExtension. Member tier name

created_datestringOptionalSign-up time

Privacy

Send only masked values for cellphone and email. Cafe24 returns them in plain text, but mask them before sending to Lillo.

PreviousStatus mapping NextProducts & catalog