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).

Sample Request

curl

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)"
  }
}