Bank Account Verification

Verify Bank Account

Verihubs Bank Account Verification validates bank account ownership. It helps prevent fraud, ensure accurate payouts, and support secure onboarding. Please check Verihubs Guidelines to learn more on how to use this endpoint.

This method verifies a bank account and returns the account name registered for the given bank code and account number.

Create your App-ID and API-Key on the Verihubs dashboard.

Outcome Description

Outcome	HTTP Status	Error Code	Charged
Account exists	200	-	See your commercial agreement
Account does not exist	400	VHB_40010	Yes
Account is dormant	400	VHB_40011	Yes
Account is closed	400	VHB_40012	Yes

Account status outcomes (not found, dormant, closed) are returned as 400 responses with an error_code. Use error_code, not only the HTTP status, to decide how to handle a response.

Error Code Description

Error Code	Name	Message	HTTP	Charge Status
VHB_50000	INTERNAL_ERROR	There's a problem with our system.	500	Not charged
VHB_40000	BAD_REQUEST	There's a problem with your request	400	Not charged
VHB_40001	BAD_HEADERS	There's a problem with your request Headers	400	Not charged
VHB_40001	BAD_PAYLOAD	There's a problem with your JSON payload	422	Not charged
VHB_40002	NOT_AUTHORIZED	You don't have permission to access this resource	401	Not charged
VHB_40003	HTTP_ERROR	There's a problem with the HTTP Request	400	Not charged
VHB_40004	INSUFFICIENT_QUOTA	You don't have enough quota; please contact our admin	400	Not charged
VHB_40010	BAD_REQUEST	Account does not exist	400	Charged
VHB_40011	BAD_REQUEST	Account is dormant	400	Charged
VHB_40012	BAD_REQUEST	Account is closed	400	Charged
VHB_42900	TOO_MANY_REQUESTS	Too many requests	429	Not charged

post/v1/bank-account/verify

Request

Base URL
https://api.verihubs.com
URL
https://api.verihubs.com/v1/bank-account/verify
Auth
none declared. Required headers: App-ID, API-Key

Headers

App-IDstring required

Application ID, created on the Verihubs dashboard.

API-Keystring required

API key, created on the Verihubs dashboard. Keep it server-side and never expose it in client-side code.

Request body

bank_codestring required

Bank code (the bank's short name). Not case-sensitive (BCA and bca are equivalent). Find all accepted values here.

account_numberstring required

Account number to verify. Digits only.

reference_idstring

Optional. Unique ID from your system, useful for reconciliation. If empty or not included in the request, Verihubs will generate the unique reference_id.

Example request

{
  "bank_code": "bca",
  "account_number": "1100000",
  "reference_id": "refid_01"
}

Response

Successful Response

messagestring required

Message

Example response

{
  "message": "success verify bank account",
  "data": {
    "id": "42197b47-ff5b-48f7-969c-f2c81cd4abcd",
    "account_name": "John Doe",
    "bank_code": "BCA",
    "account_number": "1100000",
    "reference_id": "refid_01"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.