Customers
Look up customers and see their purchase, subscription, and revenue summaries.
Use customer endpoints to connect an email address with its purchase history in your store. Use an API key with the invoice ability or OAuth with orders:read for reads and orders:write for mutations. Send the store slug in X-STORE. The account must also have invoice access for that store.
The API returns the customer's email because it is the store-specific purchase identity. Checkout IP addresses, billing details, location, and community account identifiers are intentionally excluded. Revenue is returned as insights.revenue_usd_cents.
Wallet status and balance are omitted unless both the token and staff role have wallet or store management permission. When included, wallet.balance_cents uses integer USD cents.