Customers

Customer endpoints require a bearer token with the invoice ability and an X-STORE header containing the store slug. The authenticated staff member 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.