Bank Account Verification
This endpoint allows you to verify the validity of a bank account.
Endpoint: POST {baseurl}/v1/api/verification/bank-account
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
accountNumber | string | Yes | The bank account number to verify. |
bankCode | string | Yes | The bank code for the account. |
country | string | Yes | The country code (e.g., "NGA" for Nigeria). |
reference | string | Yes | A unique reference for the verification request. |
verificationLevel | string | No | The level of verification to perform (e.g., "basic"). |
customer | string | No | ID of the customer (optional). |
verificationGroup | string | No | ID of the verification group (optional). |
Supported Countries
- Nigeria (Country Code: NGA)
Sample Request
curl -X 'POST' \
'http://localhost:4000/v1/api/verification/bank-account' \
-H 'accept: application/json' \
-H 'x-api-key: {API-KEY}' \
-H 'Content-Type: application/json' \
-d '{
"accountNumber": "4444444444",
"bankCode": "214",
"country": "NGA",
"reference": "09876543567890000002020008006",
"verificationLevel": "basic",
"customer": "68922a8c839016cfca2ff038",
"verificationGroup": "68ada27c2e94452b66f779b0"
}'Sample Response
{
"status": true,
"responseCode": "00",
"statusCode": "200",
"message": "Bank account verification successful",
"data": {
"accountNumber": "4444444444",
"accountName": "John Doe",
"bankName": "First Bank of Nigeria",
"bankCode": "214"
},
"meta": {
"statusCode": "200",
"isValid": true,
"timeStamp": "Wed Apr 23 2025 07:15:01 GMT+0000 (Coordinated Universal Time)"
}
}