Lire un client par son identifiant
GET
/v1/customers/{id}
Permission read_customers
Compte comme une lecture
Renvoie la fiche complète d'un client : identité, coordonnées, adresse, consentements, fidélité et champs personnalisés.
Un client supprimé dans l'application est introuvable : l'appel répond 404, comme si le client n'avait jamais existé.
Paramètres
id |
Obligatoire | Identifiant du client (champ id). |
Exemple d'appel
curl "https://api.wanapos.com/v1/customers/1842" \ -H "Authorization: Bearer VOTRE_CLE"
Réponse en cas de succès (statut 200)
La fiche du client.
| Champ | Type | Description |
|---|---|---|
data |
objet |
Un client du compte. Les noms de champs sont ceux des événements sortants client_create et client_update. Voir tous les champs
|
meta |
objet | |
meta.request_id |
texte | Identifiant de l'appel, à communiquer à l'assistance en cas de problème. |
{
"data": {
"id": 1842,
"civilite": "Mme",
"nom": "Martin",
"prenom": "Claire",
"nom_2": "",
"email": "claire.martin@exemple.com",
"tel": "",
"mobile": "0600000000",
"bc_ext": "",
"remise_pc": 0,
"notes": "",
"libre_1": "",
"libre_2": "",
"libre_3": "",
"custom_io_1": false,
"custom_io_2": false,
"custom_io_3": false,
"custom_date_1": "",
"custom_date_2": "",
"custom_date_3": "",
"news_sms": false,
"news_email": true,
"fidelite_active": true,
"actif": true,
"id_shop_origin": 1,
"date_creation": "2026-03-14T10:22:00+01:00",
"date_update": "2026-10-02T16:05:00+02:00",
"adresse": {
"ligne1": "12 rue des Lilas",
"ligne2": "",
"cp": "69003",
"ville": "Lyon",
"id_pays": 63,
"pays_code": "FR",
"pays": "France",
"tva_intra": "",
"archived": false
},
"fidelite": {
"points_actuels": 120,
"points_cumules": 340,
"nb_fois_pts_utilises": 2,
"last_pts_acquis": 15,
"total_ca": 412.5,
"total_qt": 17,
"total_pa": 9
},
"champs_personnalises": [
{
"cle": "libre_1",
"libelle": "Customisé 1",
"type": "texte",
"affiche": false,
"valeur": ""
},
{
"cle": "libre_2",
"libelle": "Customisé 2",
"type": "texte",
"affiche": false,
"valeur": ""
},
{
"cle": "libre_3",
"libelle": "Customisé 3",
"type": "texte",
"affiche": false,
"valeur": ""
},
{
"cle": "custom_io_1",
"libelle": "Customisé 1",
"type": "oui_non",
"affiche": false,
"valeur": false
},
{
"cle": "custom_io_2",
"libelle": "Customisé 2",
"type": "oui_non",
"affiche": false,
"valeur": false
},
{
"cle": "custom_io_3",
"libelle": "Customisé 3",
"type": "oui_non",
"affiche": false,
"valeur": false
},
{
"cle": "custom_date_1",
"libelle": "Customisé 1",
"type": "date",
"affiche": false,
"valeur": ""
},
{
"cle": "custom_date_2",
"libelle": "Customisé 2",
"type": "date",
"affiche": false,
"valeur": ""
},
{
"cle": "custom_date_3",
"libelle": "Customisé 3",
"type": "date",
"affiche": false,
"valeur": ""
}
]
},
"meta": {
"request_id": "3f9a1c0b7d2e4a61"
}
}
Erreurs possibles
-
404
L'élément demandé n'existe pas sur ce compte. Code :
resource_not_found. -
401
Clé absente, inconnue ou révoquée. Codes :
missing_key,invalid_key. -
403
Appel refusé pour ce compte ou cette clé. Codes :
api_not_activated,account_not_eligible,access_blocked,missing_scope. -
422
Un paramètre est absent, inconnu ou invalide. Code :
invalid_parameter. Le champfieldnomme le paramètre. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
