Customers
Get a customer
GET
Returns one customer.
apiKeyheader
AuthorizationBearer <token>A store API key from Settings → Developers → API keys, sent as Authorization: Bearer zk_live_….
id*stringThe resource id
Format
uuidSuccess
application/json- response
object*"customer"Value in
"customer"id*stringname*stringemail*stringphone*stringsource*stringHow the customer joined the store
Value in
"checkout""newsletter""manual"email_status*stringValue in
"valid""invalid""bounced""complained"unsubscribed_at*stringWhen they opted out of marketing email; null if subscribed
tags*array<string>created_at*stringISO 8601 timestamp
updated_at*stringISO 8601 timestamp
curl -X GET "https://example.com/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "object": "customer", "id": "00000000-0000-4000-8000-0000000000c1", "name": "Sara Ahmed", "email": "sara@example.com", "phone": "+966500000000", "source": "checkout", "email_status": "valid", "unsubscribed_at": null, "tags": [ "vip" ], "created_at": "2026-09-12T14:20:00.000Z", "updated_at": "2026-10-01T09:30:00.000Z"}