Get Virtual Account
Retrieve comprehensive details about a specific virtual account using its account number
Retrieve comprehensive details about a specific virtual account using its account number.
Endpoint: https://api.chapa.co/v1/virtual-account/{accountNumber}
Method: GET
Authorization: Pass your secret key as a bearer token in the request header to authorize this call.
Path Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
accountNumber | Yes | string | The unique identifier of the virtual account to be retrieved |
cURL
PHP
Python
Successful Response
{
"status": "success",
"message": "Virtual Account Fetched Successfully",
"data": {
"account_name": "SEMER NUR",
"account_number": 100314252,
"account_alias": "1234542",
"balance": 20,
"status": "active",
"currency": "ETB",
"created_at": "2025-02-21T08:06:54.000000Z",
"updated_at": "2025-02-21T08:06:54.000000Z"
}
}Response Parameters
| Parameter | Type | Description |
|---|---|---|
status | string | Status of the request (success/error) |
message | string | Response message |
data.account_number | number | Unique identifier of the virtual account |
data.account_name | string | Name associated with the account |
data.account_alias | string | Custom reference name for the account |
data.balance | number | Current balance in the account |
data.currency | string | Currency of the account (e.g., ETB) |
data.status | string | Current status of the account (e.g., active) |
data.created_at | string | Timestamp of account creation |
data.updated_at | string | Timestamp of the most recent transaction |
Failed Response
{
"status": "error",
"message": "Virtual Account Not Found",
"errors": {
"failure_reason": "Transaction failed."
}
}Refer to our Error Codes page for all responses for this request.
Use Cases
- Balance Checking: Verify account balance before processing transactions
- Account Verification: Confirm account exists and is active
- Reconciliation: Retrieve account details for reconciliation purposes
- Status Monitoring: Check account status and recent activity
Next Steps
- Create Virtual Account - Create a new virtual account
- Error Codes - Handle errors gracefully