> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pulse-sell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clients

> Les acheteurs de votre boutique, dérivés de vos ventes encaissées.

Un **client** est une adresse e-mail qui a au moins une vente encaissée dans votre boutique. Il n'y a rien à créer ni à synchroniser : la liste se déduit de vos ventes, donc elle est toujours exacte.

> [!NOTE]
>
> Permission : `customers.read`. Référence : [Clients](https://docs.pulse-sell.com/api-reference/clients).

```bash theme={null}
curl "https://api.pulse-sell.com/v1/customers?q=@exemple.com&per_page=50" \
  -H "Authorization: Bearer $PULSESELL_API_KEY"
```

```json theme={null}
{
  "id": "cus_YXdhQGV4YW1wbGUuY29t",
  "email": "awa@example.com",
  "name": "Awa Koné",
  "phone": "+2250700000000",
  "orders_count": 3,
  "total_spent": [ { "value": 60000, "formatted": "60 000 F CFA", "currency": "XOF" } ],
  "first_order_at": "2026-08-02T10:00:00.000Z",
  "last_order_at": "2026-10-29T16:17:10.000Z"
}
```

* `total_spent` est une liste : un client qui a acheté dans plusieurs devises a une ligne par devise, sans conversion approximative.
* L'identifiant `cus_…` est stable et se dérive de l'e-mail : vous pouvez l'utiliser directement dans `GET /customers/{id}`.
* La liste est triée par e-mail ; `q` recherche dans l'adresse.

## Retrouver les achats d'un client

```bash theme={null}
curl "https://api.pulse-sell.com/v1/sales?customer_email=awa@example.com" \
  -H "Authorization: Bearer $PULSESELL_API_KEY"
```

> [!NOTE]
>
> Respectez la vie privée de vos clients : ne stockez que ce dont vous avez besoin, et ne journalisez pas leurs adresses e-mail en clair.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.