# Kunden finden

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/api/kunden-finden/

GET /v1/clients findet einen Kunden über seine Telefonnummer, seine E-Mail-Adresse oder den Code seiner Karte.

`GET /v1/clients`

Findet einen Kunden des Geschäfts. Geben Sie **nur einen** der drei Abfrageparameter an (sonst `400 recherche_requise`):

**Abfrageparameter**

- `telephone` (string, optional) : Die Nummer, in der Adresse kodiert (`%2B33612345678`). Sie wird im Land des Geschäfts gelesen: `0612345678` und `+33612345678` werden beide gefunden.
- `email` (string, optional) : E-Mail-Adresse, ohne Beachtung der Groß- und Kleinschreibung.
- `carte` (string, optional) : Der Code der Karte, der in ihrem QR-Code steckt.

## Beispiel

```bash title="curl"
curl "https://app.stampywallet.com/v1/clients?telephone=%2B33612345678" \
  -H "Authorization: Bearer sw_live_votre_cle"
```

## Antwort

```json title="200 OK"
{
  "clients": [
    {
      "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
      "prenom": "Léa",
      "nom": "Martin",
      "telephone": "+33612345678",
      "email": null,
      "carte": "X7k2pQ9mLw",
      "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
      "cree_le": "2026-10-25T10:41:52.120Z",
      "etat": { "mode": "tampons", "tampons": 7, "points": null, "objectif": 10, "restants": 3,
                "prochaine_recompense": { "seuil": 10, "libelle": "Ein Baguette gratis" },
                "recompenses_disponibles": [], "recompenses_obtenues": 1,
                "dernier_passage": "2026-10-28T08:02:11.000Z", "premium": null }
    }
  ]
}
```

Die Liste ist leer (`"clients": []`), wenn niemand passt: Das ist kein Fehler. Haben mehrere Einträge dieselbe E-Mail-Adresse oder dieselbe Nummer, wird der Kunde mit dem jüngsten Besuch zurückgegeben. Alle Felder im Detail: [das Kundenobjekt](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet).
