Aller au contenu
StampyWalletDocs
API et webhooks / Référence / Retrouver un client

Retrouver un client

GET /v1/clients retrouve un client par son téléphone, son e-mail ou le code de sa carte.

GET/v1/clients

Retrouve un client du commerce. Donnez un seul des trois paramètres de requête (sinon 400 recherche_requise) :

Paramètres de requête

telephonestringfacultatif
Le numéro, encodé dans l'adresse (%2B33612345678). Il est lu dans le pays du commerce : 0612345678 et +33612345678 se retrouvent.
emailstringfacultatif
Adresse e-mail, sans tenir compte des majuscules.
cartestringfacultatif
Le code de la carte, celui que porte son QR.

Exemple

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

Réponse

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": "Une baguette tradition offerte" },
                "recompenses_disponibles": [], "recompenses_obtenues": 1,
                "dernier_passage": "2026-10-28T08:02:11.000Z", "premium": null }
    }
  ]
}

La liste est vide ("clients": []) quand personne ne correspond : ce n'est pas une erreur. Quand plusieurs fiches portent le même e-mail ou le même numéro, c'est la plus récemment venue qui est rendue. Le détail des champs : l'objet client.

Mis à jour le

Cette page vous a aidé ?