Listar Cuentas

Visión General

Este endpoint permite crear un Cliente (Customer) dentro de la API de Passport proporcionando los datos de identificación necesarios. Una solicitud exitosa retorna el ID del cliente y la información de confirmación del recurso creado.

Detalles del Endpoint

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

Este endpoint retorna todas las cuentas vinculadas a la entidad autenticada.

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' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data ''
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK
Retorna los datos de todas las cuentas creadas junto con sus IDs únicos.

Ejemplo de Respuesta

JSON
    
 
{
    "accounts": [
        {
            "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"
        }
    ],
    "pagination_info": {
        "first_request_timestamp": "2025-10-09T17:43:22.10Z",
        "current_page": 1,
        "total_pages": 1,
        "total_elements": 1
    }
}
Copy

available_balance representa los fondos disponibles para su uso inmediato, pending_balance refleja 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	La solicitud no está autorizada para listar las cuentas.
500 Server Error	Error del servidor	Ocurrió un error inesperado al recuperar las cuentas.

Buenas Prácticas

Asegúrate de que el token de autenticación sea válido antes de realizar la solicitud.
Utiliza paginación si estás trabajando con grandes volúmenes de cuentas.
Supervisa los saldos de cuenta para evitar errores de fondos insuficientes al realizar transacciones.

Última actualización el