# Kunden abrufen

> 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-abrufen/

GET /v1/clients/:id liefert einen Kunden und den Stand seiner Stempelkarte, Stempel, Punkte und einzulösende Prämien.

`GET /v1/clients/:id`

Liefert einen Kunden und den Stand seiner Karte. `:id` ist die UUID, die [`POST /v1/clients`](https://stampywallet.com/de/docs/api/kunden-anlegen/) oder [`GET /v1/clients`](https://stampywallet.com/de/docs/api/kunden-finden/) zurückgibt. Eine unbekannte ID antwortet mit `404 client_introuvable`.

```bash title="curl"
curl https://app.stampywallet.com/v1/clients/c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7 \
  -H "Authorization: Bearer sw_live_votre_cle"
```

## Das Kundenobjekt

Dasselbe Objekt kommt in allen Kundenrouten zurück und im Feld `client` der anderen Antworten:

```json title="200 OK"
{
  "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
  "prenom": "Léa",
  "nom": "Martin",
  "telephone": "0612345678",
  "email": "lea@exemple.fr",
  "carte": "X7k2pQ9mLw",
  "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
  "cree_le": "2026-10-22T09:14:03.120Z",
  "etat": {
    "mode": "tampons",
    "tampons": 3,
    "points": null,
    "objectif": 10,
    "restants": 7,
    "prochaine_recompense": { "seuil": 10, "libelle": "Ein Kaffee gratis" },
    "recompenses_disponibles": [
      { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "seuil": 10,
        "piste": "normal", "obtenue_le": "2026-10-20T16:03:44.000Z", "expire_le": null }
    ],
    "recompenses_obtenues": 1,
    "dernier_passage": "2026-10-22T09:20:00.000Z",
    "premium": null
  }
}
```

| Feld | Bedeutung |
|---|---|
| `carte` | Der Code der Karte, der in ihrem QR-Code steckt |
| `lien_carte` | Die Seite der Karte, die das Hinzufügen zu Apple Wallet oder Google Wallet anbietet |
| `etat.tampons`, `etat.points` | `tampons` in den Modi Stempel und Stufen, `points` im Punktemodus; der andere Wert ist `null` |
| `etat.restants` | Was bis zur nächsten Prämie noch fehlt |
| `etat.recompenses_disponibles` | Die verdienten, noch nicht eingelösten Prämien: Mit ihrer `id` können Sie [sie einlösen](https://stampywallet.com/de/docs/api/praemie-einloesen/) |
| `etat.premium` | `{ nom, tampons, objectif, restants }`, wenn das Geschäft den zweiten Zähler aktiviert hat, sonst `null` |

> **Hinweis :** IDs sind UUIDs. Die Präfixe `cli_`, `pas_` oder `rec_` vor einer UUID werden bei der Eingabe akzeptiert und ignoriert.
