Customer document (Shop API 23.2)

(supports custom properties)

Document representing a customer.

Property Type Constraints Description
addresses [CustomerAddress]   The customer's addresses.
auth_type Enum {guest, registered}   The customer's authorization type (indicates if the customer is a guest or a registered customer).
birthday LocalDate   The customer's birthday.
company_name String maxLength=256 The customer's company name.
creation_date Date   Returns the value of attribute 'creationDate'.
customer_id String maxLength=28 The customer's number (id). Both registered and guest customers have a customer id.
customer_no String maxLength=100 The customer's number (id). Only a registered customer has a customer number.
email String maxLength=256 The customer's email address.
enabled Boolean   A flag indicating whether this customer is is enabled and can log in.
fax String maxLength=32 The customer's fax number. The length is restricted to 32 characters.
first_name String maxLength=256 The customer's first name.
gender Integer   The customer's gender.
hashed_login String   The customer's hashed LoginId which is used for activity tracking for logged in customers in conjunction with visitId. This field is READ-ONLY
job_title String maxLength=256 The customer's job title.
last_login_time Date   The time when the customer last logged in.
last_modified Date   Returns the value of attribute 'lastModified'.
last_name String maxLength=256 The customer's last name.
last_visit_time Date   The time when the customer last visited.
login String maxLength=256 The customer's login.
note String   The customer's note.
payment_instruments [CustomerPaymentInstrument]   The customer's payment instruments.
phone_business String maxLength=32 The customer's business phone number.
phone_home String maxLength=32 The customer's home phone number.
phone_mobile String maxLength=32 The customer's mobile phone number.
preferred_locale String   The customer's preferred locale.
previous_login_time Date   The time when the customer logged in previously.
previous_visit_time Date   The time when the customer last visited the store.
salutation String maxLength=256 The salutation to use for the customer.
second_name String maxLength=256 The customer's second name.
suffix String maxLength=256 The customer's suffix (for example, "Jr." or "Sr.").
title String maxLength=256 The customer's title (for example, "Mrs" or "Mr").
visit_id String   The customer's visitId. This field is READ-ONLY
X OCAPI versions 15.x and 16.x will be retired on March 31, 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.
Notifications pending to read 9