Retrieve Account

Overview

This endpoint allows you to retrieve details of a specific account within the Passport API using the account's unique ID. The response includes account type, number, balance information, and associated entity details.

Endpoint Details

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

Request Body

No request body

Example Request

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

Response Body

HTTP Status Code: 200 OK.
The response contains the account information.

Example of Response

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

The available_balance represents the 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 account ID is missing or incorrectly formatted.
401 Unauthorized	Expired Token	The access token is invalid or has expired.
403 Forbidden	Access Denied	The request is not authorized to retrieve this account.
404 Not Found	Account Not Found	No account was found with the given ID.
500 Internal Server Error	Server Error	An unexpected error occurred while retrieving the account details.

Best Practices

Ensure the account_id is correctly provided in the request URL.
Use the retrieved account details to manage transactions and funds.

Last updated on