Get Customer
The following endpoint can be used to retrieve the details of a customer within the Hyfin application.
Punto Final
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/site/{site_id}/customer/{external_id}
Solicitud
Ningún cuerpo es necesario para esta llamada de API
Respuesta
Campo
Tipo
Requerido
Descripción
external_id
String
The unique customer id from the source system/database. If we detect a record with the same `external_id`, it will be updated, otherwise it will be added.
first_name
String
El primer nombre del cliente.
last_name
String
El apellido del cliente.
account_name
String
--
Si el cliente es una empresa, puedes usar este campo como un identificador adicional (Ej. 123 Main Street o ABC Company).
mobile_phone
String
--
The customers mobile phone number. Required if `notification_options.notify_phone` is enabled.
email
String
--
The customers email address. Required if `notification_options.notify_email` is enabled.
notes
String
--
Notas internas del cliente. Visible solo para el comerciante.
active
Boolean
--
Si el registro del cliente está activo y disponible para ser utilizado.
Default = `true`
Default = `true`
notification_options
--
Las preferencias del cliente para recibir notificaciones por mensaje de texto y correo electrónico.
created_at
Date
--
La fecha en que se creó el cliente.
updated_at
Date
--
La fecha en que se actualizó por última vez el cliente.
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"
}