Skip to main content

Customers

The Customers API lets you read your store's customers and their purchase history.

Overview

The Customers API provides endpoints to:

A customer is a person who has bought from your store. The API is read-only — customer name and email are login identity and cannot be edited through the API.

Currency scope

Customers, their lifetime value, and their order history are tracked per currency — a customer who has only ever paid in PLN does not appear when you ask for EUR. For this reason every endpoint requires a currency query parameter. See Get Store for the currencies your store transacts in.

currency scopes the money sections only (lifetime value, order counts, and the order list). Subscriptions and one-time product access are store-scoped, not per currency, so they are returned regardless of the currency you pass.