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

The first name of the customer. At least one of first_name, last_name, account_name, email, or mobile_phone is required.

last_name

String

The last name of the customer. At least one of first_name, last_name, account_name, email, or mobile_phone is required.

account_name

String

If the customer is a business, you may use this field as an extra identifier (Ex. 123 Main Street or ABC Company). At least one of first_name, last_name, account_name, email, or mobile_phone is required.

mobile_phone

String

The customers mobile phone number. Required if notification_options.notify_phone is enabled. At least one of first_name, last_name, account_name, email, or mobile_phone is required.

String

The customers email address. Required if notification_options.notify_email is enabled. At least one of first_name, last_name, account_name, email, or mobile_phone is required.

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

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"
}