Consultar Cuenta

Visión General

Este endpoint permite consultar los detalles de una cuenta específica dentro de la API de Passport utilizando su identificador único. La respuesta incluye el tipo de cuenta, número, saldos disponibles y pendientes, así como la relación con el cliente entidad correspondiente.

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/accounts/:account_id
Método	GET
Encabezados	Authorization
Autenticación	Token de Acceso (Bearer Token)

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/accounts/6c23f053-0e1a-46b4-b902-97ba47e351bc' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data ''
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK
Retorna los datos de la cuenta asociada al cliente junto con su ID único.

Ejemplo de Respuesta

JSON
    
 
{
    "updated_at": "2025-10-09T17:41:23.179Z",
    "pending_balance": {
        "value": "0",
        "currency": "COP"
    },
    "customer_id": "db7e89e7-59d8-4ab1-b675-a2ae52c3339e",
    "account_type": "ORDINARY",
    "status": "ACTIVE",
    "account_number": "88827643001",
    "created_at": "2025-10-09T10:40:29.966Z",
    "available_balance": {
        "value": "90000000000000000",
        "currency": "COP"
    },
    "id": "6c23f053-0e1a-46b4-b902-97ba47e351bc"
}
Copy

El campo available_balance representa los fondos disponibles para ser utilizados de forma inmediata, mientras que pending_balance refleja las transacciones que aún están en proceso de liquidación.

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 tienes permisos para consultar esta cuenta.
404 Not Found	Cuenta no encontrada	No se encontró ninguna cuenta con el ID proporcionado.
500 Server Error	Error del servidor	Error inesperado al consultar los detalles de la cuenta.

Buenas Prácticas

Verifica que el id de la cuenta esté correctamente formateado y presente en la URL.
Usa los detalles de la cuenta obtenidos para gestionar transacciones o consultar saldos.

Última actualización el