Skip to main content
GET
/
user
/
verify-bank-account
/
{bankCode}
/
{accountNumber}
Verify Bank Account
curl --request GET \
  --url https://{tenant}.fincode.software/api/v1/services/user/verify-bank-account/{bankCode}/{accountNumber}
Verifies the provided bank account details and returns the account holder’s name if valid. This is used before adding a bank account for withdrawals.

​
Request Headers

​
X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
​
x-idempotency-key
string
required
Unique idempotency key for the request to prevent duplicate processing.
​
x-fapi-auth-date
string
required
The date and time at which the request was initiated (ISO 8601 format).
​
x-fapi-customer-ip-address
string
required
The IP address of the customer making the request.
​
x-fapi-interaction-id
string
required
Unique identifier for the interaction/session.

​
Path Parameters

​
bankCode
string
required
The code of the bank (retrieved from Get Available Banks).
​
accountNumber
string
required
The account number to verify.

Path Parameters

​
bankCode
string
required
​
accountNumber
string
required

Response

200

Account verified