Get Customer
The following endpoint can be used to retrieve the details of a customer within the Hyfin application.
Point de terminaison
The following endpoint can be used to retrieve a customer. You must replace the {base_url} , {site_id} and {external_id} variables with the appropriate values.
GET
{base_url}/api/v3.1/site/{site_id}/customer/{external_id}
Demande
Aucun corps n'est requis pour cet appel API
Réponse
Champ
Type
Description
external_id
String
Le numéro d'identification unique du client provenant du système/base de données source. Si nous détectons un enregistrement avec le même external_id, il sera mis à jour, sinon il sera ajouté.
first_name
String
Le prénom du client. Au moins l'un de first_name, last_name, account_name, email ou mobile_phone est requis.
last_name
String
Le nom de famille du client. Au moins l'un de first_name, last_name, account_name, email ou mobile_phone est requis.
account_name
String
Si le client est une entreprise, vous pouvez utiliser ce champ comme identifiant supplémentaire (Ex. 123 rue Principale ou Entreprise ABC). Au moins l'un de first_name, last_name, account_name, email ou mobile_phone est requis.
mobile_phone
String
Le numéro de téléphone mobile du client. Requis si notification_options.notify_phone est activé. Au moins l'un de first_name, last_name, account_name, email ou mobile_phone est requis.
email
String
L'adresse courriel des clients. Requis si notification_options.notify_email est activé. Au moins l'un de first_name, last_name, account_name, email ou mobile_phone est requis.
notes
String
Notes internes pour le client. Visible seulement par le commerçant.
active
Boolean
Que le dossier du client soit actif et disponible pour être utilisé.
Default = true
Default = true
notification_options
Les préférences du client pour recevoir des notifications par message texte et courriel.
created_at
Date
La date à laquelle le client a été créé.
updated_at
Date
La date à laquelle le client a été mis à jour pour la dernière fois.
Sample Response
{
"_id": "6839e415564d3cc2160d945e",
"external_id": "39772634",
"first_name": "John",
"last_name": "Doe",
"account_name": null,
"mobile_phone": "12223334444",
"email": "johndoe@abc.com",
"notification_options": {
"notify_phone": true,
"notify_email": false
},
"created_at": "2025-05-30T19:19:44.143Z",
"updated_at": "2025-05-30T19:19:44.143Z"
}