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
3
3
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/accounts' \--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \--data ''Response Body
Example of Response
27
27
{ "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 }}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.