Consultar Cliente

Visión General

Este endpoint permite consultar los detalles de un cliente registrado en la API de Passport utilizando su identificador único. La respuesta incluye información de identificación, razón social y datos de contacto.

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/{entity_customer_id}
Método	GET
Encabezados	Authorization
Autenticación	Token de Acceso (Bearer Token)

Reemplaza {entity_customer_id} con el ID único del cliente.

Cuerpo de la Solicitud

No se requiere cuerpo en la solicitud para este endpoint

Ejemplo de Solicitud

JSON
    
    
 
curl --location 'https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/f5ac1885-f6c1-408c-9500-8348e715f3e7' \
--header 'Authorization: Bearer TU_TOKEN_DE_ACCESO' \
--data ''
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK.
La respuesta devuelve los detalles del cliente.

Ejemplo de Respuesta

JSON
    
 
{
    "type": "BUSINESS",
    "id": "f5ac1885-f6c1-408c-9500-8348e715f3e7",
    "email": "kaXrNR1d@example.com",
    "mobile_phone_number": "573412389966",
    "identification_type": "NIT",
    "identification_number": "915467173",
    "business_name": "Test Business 00XYF"
}
Copy

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400 Bad Request	Datos inválidos	Faltan campos requeridos o contienen valores incorrectos.
401 Unauthorized	Token inválido	El token de acceso ha expirado o es inválido.
403 Forbidden	Acceso denegado	No se tienen permisos para consultar este cliente.
404 Not Found	Cliente no encontrado	No se encontró ningún cliente con el ID proporcionado.
500 Server Error	Error del servidor	Ocurrió un error inesperado al consultar el cliente.

Buenas Prácticas

Verifica que el id del cliente esté correctamente formateado y presente en la URL.
Usa el id de la cliente retornado para futuras interacciones con la API.

Última actualización el