Clients

Lire un client par son identifiant

GET /v1/customers/{id}
vpn_key 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 champ field nomme le paramètre.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.

Voir toutes les erreurs

Une question ? contact@wanapos.com