Retrieve a list of users

This API retrieves a list of users that match specific rule criteria.

Response Model

Json propertyData typeDescription
guestsListReturned users that match the rule criteria, when successful.
errorApiErrorModelError information when the request fails or is blocked.

guests object (RuleUser)

Json propertyData typeDescription
idGuidUnique identifier of the user.
namestringFull name of the user.
first_namestringUser’s first name.
last_namestringUser’s last name.
user_codestringExternal or custom user code.
base_centerstringHome center name or identifier.
genderstringGender value recorded for the user.
typestringGuest type classification or label.
spentdoubleLifetime spend attributed to the user.
emailstringEmail address for the user.
mobile_phonestringMobile phone number.
home_phonestringHome phone number.
address1stringAddress line one.
address2stringAddress line two.
citystringCity of the user’s address.
zipcodestringPostal or ZIP code.
statestringState or province.
countrystringCountry name or code.
nationalitystringNationality of the user.
dobDateTime?Date of birth, when available.
anniversary_dateDateTime?Anniversary date, when applicable.
visitsintTotal number of recorded visits.
first_visitDateTime?Date of the first visit recorded.
last_visitDateTime?Date of the most recent visit.
referral_sourcestringHow the user was referred.
receive_marketing_emailboolConsent flag for marketing emails.
receive_marketing_smsboolConsent flag for marketing SMS.
receive_marketing_whatsappboolConsent flag for WhatsApp marketing.
relationship_managerstringAssigned relationship manager’s name.
relationship_manager_idstringIdentifier of the relationship manager.
target_segment_centerstringCenter used for segment evaluation context.
creation_dateDateTime?User profile creation timestamp.

error object (ApiErrorModel)

Json propertyData typeDescription
codestringApplication error code indicating the failure reason.
messagestringHuman-readable description of the error encountered.
Language
Credentials
Header
Click Try It! to start a request and see the response here!