Get member by filter

GET

/api/v2.0/stores/{storeId}/members/search

curl -s -G "$DILLER_BASE/api/v2.0/stores/$STORE_ID/members/search" \
  --data-urlencode "phone=+4799900001" \
  -H "Authorization: Bearer $TOKEN"

# Exactly one of phone, email, identifierValue or activationToken.
# A member who does not exist is 200 with [], not 404.

• Production
• Prerelease (sandbox)

Searches members by email, phone number, activation token or any other identifier (country dependant - eg. SSN, licence plate, National ID)

Authorizations

• OAuth2

Parameters

Path Parameters

storeId

required

string

The member’s store id

Example

your-store-id

Query Parameters

email

string

Email Address of the member

Example

ola.nordmann@example.com

phone

string

The phone number can be entered in international format, starting with either “00” or “+”. If the phone number is entered in national format, it will be assumed that the number belongs to the same country as the store

Example

+4799900001

identifierValue

string

The extra identifier of a member defined at the store level.

Example

42

activationToken

string

The token value for when a member signed up via POS or any other source, that requires an activation step.

Example

996405d26e29

cardIdentifier

string

The card identifier linked to the member

Example

your-card-identifier

Responses

200

OK

Media typeapplication/json

Array<object>

object

id

string

nullable

first_name

string

nullable

last_name

string

nullable

email

string

nullable

additional_identifiers

DEPRECATED: Start using the ‘Identifiers’ endpoints instead

Array<string>

nullable

identifiers

Array<object>

nullable

object

id

integer format: int32

type_id

integer format: int32

type

string

nullable

value

string

nullable

remarks

string

nullable

phone

object

country_code

required

string

>= 1 characters

number

required

string

>= 1 characters

birth_date

string format: date-time

nullable

address

object

street

string

nullable

city

string

nullable

zip_code

string

nullable

state

string

nullable

country_code

The alpha-2 code of country

string

nullable

gender

required

string

Allowed values: Male Female NotShared NonBinary

consent

object

gdpr_accepted

True if the member has accepted the GDPR. False otherwise.

boolean

save_order_history

True if member has authorized to save order history e.g. transaction details about their purchases.

boolean

receive_sms

True if the member has authorized the sending of promotional SMS. False otherwise.

boolean

receive_email

True if the member has authorized the sending of promotional Emails. False otherwise.

boolean

membership_detail

object

points

number format: double

qualification_points

number format: double

pending_points

number format: double

remaining_points

number format: double

level_title

string

nullable

next_level_title

string

nullable

next_level_points

number format: double

level_expire_date

string format: date-time

nullable

department_ids

Array<string>

nullable

segments

Array<object>

nullable

object

id

integer format: int32

text

string

nullable

type

required

string

Allowed values: Text DateTime Radio Checkbox Dropdown

is_visible_to_follower

boolean

is_required

boolean

value

Use value when segment type is Date or Text

string

nullable

selected_options

Use SelectedOptions when segment type is Radio, Combobox or Dropbox

Array<integer>

nullable

has_wallet_pass

boolean

Example

[
  {
    "birth_date": "2026-09-11T12:34:49",
    "gender": "Male",
    "membership_detail": {
      "level_expire_date": "2026-09-11T12:34:49"
    },
    "segments": [
      {
        "type": "Text"
      }
    ]
  }
]

400

Bad Request

Media typeapplication/json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

errors

object

key

additional properties

Array<string>

key

additional properties

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}