List Accounts

Overview

This endpoint allows you to retrieve a list of all accounts associated with an entity customer within the Passport API. The response includes details such as account type, balance, and entity association.

Endpoint Details

Definition	Description
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/accounts
Method	GET
Headers	Authorization
Authentication	Access Token (Bearer Token)

This endpoint retrieves all accounts linked to an authenticated entity.

Request Body

No request body

Example Request

JSON
    
 
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/accounts' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data ''
Copy

Response Body

Example of Response

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

The available_balance represents funds ready for use, while pending_balance reflects transactions still being processed.

Common Errors and Handling

HTTP Status Code	Meaning	Description
400 Bad Request	Invalid Request	The request is malformed or contains invalid parameters.
401 Unauthorized	Expired Token	The access token is invalid or has expired.
403 Forbidden	Access Denied	The request is not authorized to list accounts.
500 Internal Server Error	Server Error	An unexpected error occurred while retrieving accounts.

Best Practices

Ensure the authentication token is valid before making a request.
Check Pagination if needed when dealing with large data sets.
Monitor account balances to prevent insufficient funds errors in transactions.

Last updated on