# Bank Enquiry
Bank Enquiry allows you to verify and retrieve account details for a given bank account number before processing transactions. This helps ensure the account exists and the account holder’s information is correct.
This endpoint is commonly used for validating beneficiary details during transfers, payouts, and onboarding processes to reduce failed transactions and errors.
Note: Bank enquiry must be performed before initiating a transfer. Authentication headers are required for all requests.
Perform Bank Enquiry
To verify a bank account, send the bank code and account number. The system will return the account name and validation status if the account exists.
curl -X POST \
'{{base-url}}/v1/account/enquiry'
Request Body (JSON)
{
"bank_code": "{{bank_code}}",
"account_number": "{{account_number}}"
}
| Field | Type | Description | |
|---|---|---|---|
| Bank Code | String | Unique code identifying the customer’s bank | Required |
| Account Number | String | Customer’s bank account number | Required |
Example :
{ "status": true, "message": "Account verified successfully", "data": { "account_name": "JOHN DOE", "account_number": "0123456789", "bank_code": "058" } }
How Bank Enquiry Works
When a bank enquiry request is submitted, the system connects to the banking network to validate the provided account number against the selected bank.
If the account is valid, the account holder’s name is returned and can be used to confirm the recipient before completing a transaction.
Bank enquiry is ideal for:
- Validating beneficiary account details
- Reducing failed or misdirected transfers
- Improving transaction success rates
Tip: Always display the returned account name to users for confirmation before proceeding with a transfer.