Skip to main content
Version: 202607

Get customer

GET 
/openapi/2026-07/customers/:customer_id

Retrieve details of a specific customer using its unique identifier.

Request​

Path Parameters

    customer_id stringrequired

    Customer ID

Responses​

OK

Schema
    codestring

    error code

    messagestring

    error message

    data object
    customer object

    Customer object containing customer details

    idstring

    Customer ID

    emailstring

    Customer's email address

    created_atstring

    Timestamp when the customer was created, in ISO8601 format

    updated_atstring

    Timestamp when the customer was last updated, in ISO8601 format

    first_namestring

    Customer's first name

    last_namestring

    Customer's last name

    phonestring

    Customer's phone number

    tagsstring[]

    Tags associated with the customer

    namestring

    Full name of the customer

    phone_area_codestring

    Area code of the phone number

    contact_typestring

    Contact type, either email or phone

    sms_subscribed_flagint32

    Customer's SMS subscription status flag

    addresses object[]

    List of all customer addresses

  • Array [
    • idstring

    Address ID

    customer_idstring

    ID of the customer this address belongs to

    first_namestring

    First name of the consignee

    last_namestring

    Last name of the consignee

    companystring

    Company name

    citystring

    City of the address

    provincestring

    Province or state of the address

    countrystring

    Country name of the address

    zipstring

    Postal or ZIP code

    province_codestring

    Province code

    country_codestring

    ISO country code

    genderstring

    Gender of the consignee

    phonestring

    Phone number associated with the address

    phone_area_codestring

    Area code of the phone number

    areastring

    Area or region of the address

    emailstring

    Email associated with the address

    namestring

    Full name of the consignee

    address1string

    Primary street address

    address2string

    Secondary street address

    country_namestring

    Full name of the country

    defaultboolean

    Indicates if this is the default address

  • ]
    • accepts_marketingboolean

    Indicates if the customer is subscribed to marketing emails

    sourcestring

    Source of the customer data

    free_taxboolean

    Indicates if the customer is exempt from taxes

    registeredboolean

    Indicates if the customer is registered

    orders_countint32

    Number of orders placed by the customer

    first_order_atstring

    First order timestamp

    last_order_atstring

    Timestamp of the customer's last order

    total_spentstring

    Total amount spent by the customer

    subscribed_flagint32

    Customer's marketing subscription status flag

    accepts_sms_marketingboolean

    Indicates if the customer is subscribed to SMS marketing campaigns