Skip to main content
GET
Get Customer

Headers

authorization
string | null
X-API-Key
string | null
X-Stella-Merchant-Id
string | null

Path Parameters

customer_id
string<uuid>
required

Response

Successful Response

Schema for customer with order history.

id
string<uuid>
required
merchant_id
string<uuid>
required
last_name
string | null
required
full_name
string
required
default_address
AddressSchema · object | null
required

Schema for address. Fields are optional to support simpler address formats from AI widget.

addresses
AddressSchema · object[]
required
accepts_marketing
boolean
required
orders_count
integer
required
total_spent
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
average_order_value
number
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
orders
OrderResponse · object[]
required
email
string | null
source
string
default:web
external_id
string | null
phone
string | null
first_name
string | null
has_password
boolean
default:false
email_verified_at
string<date-time> | null
marketing_opt_in
boolean
default:false
failed_login_count
integer
default:0
locked_until_at
string<date-time> | null
saved_addresses
CustomerSavedAddress · object[]
ig_username
string | null