Bank Verification Status

GET 
/v1/users/get-bank-status/:refNumber

Get the status of bank account verification.

Request

Responses

200

Returns current bank verification status. Check the bankStatus field:

• SUCCESS — Account verified (reason: "Account is valid")
• FAILED — Verification failed. reason values:
  • "kyc name mismatch. ACCOUNT HOLDER NAME: <NAME>, kycNames: <KYC_NAME>" — account holder name does not match KYC name
  • "nre account" — NRE accounts are not supported
  • "invalid account" — account number is invalid or the account is frozen
• PENDING — Verification still in progress; retry shortly
• MANUAL — Automatic verification could not complete; user must submit a passbook or bank statement

400

Bad Request — invalid or missing reference number.

401

Unauthorized — missing or expired Bearer token or API key.