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://api.paas.sandbox.co.passportfintech.com/v1/customers/:customer_id
Método	GET
Encabezados	Authorization
Autenticación	Token de Acceso (Bearer Token)

Reemplaza :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 --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/customers/db7e89e7-59d8-4ab1-b675-a2ae52c3339e' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Copy

Cuerpo de la Respuesta

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

Ejemplo de Respuesta

JSON
    
 
{
    "business_name": "changing",
    "type": "BUSINESS",
    "created_at": "2025-10-09T10:40:27.446Z",
    "updated_at": "2025-10-09T17:19:27.951Z",
    "email": "eAqpUh6u@example.com",
    "status": "ACTIVE",
    "identification_number": "903978023",
    "merchant_category_code": "0412",
    "mobile_phone_number": "573956158117",
    "address": {
        "line_3": "Calle 20 675",
        "city": "Cartagena",
        "line_1": "Diagonal 46 1104",
        "country": "CO",
        "post_code": "101010",
        "state": "Bolivar",
        "line_2": "Carrera 18 2111"
    },
    "identification_type": "NIT",
    "id": "db7e89e7-59d8-4ab1-b675-a2ae52c3339e"
}
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