Sign in

v1

latestOpenAPI 3.0.32026-07-14108241269.2 KB
Bank Verification v2

Bank Account Verification v2

Verifies a bank account number and IFSC using the customer's configured BAV v2 setup.

Depending on customer configuration, the request may be served by a single vendor or by an orchestrated vendor sequence. In an orchestrated setup, non-retryable data errors such as invalid IFSC, invalid account number, or invalid/nonexistent account are returned without attempting another vendor. Retryable vendor or system failures may be routed to the next configured vendor.

Do not treat HTTP 200 alone as verification success. A completed verification request can return HTTP 200 with status: failed. Clients should use status == "success" for successful verification and inspect error_code for failed business outcomes.

post/v2/verify/bank_verification

Request body

account_numberstring required

Bank account number to verify.

ifsc_codestring required

IFSC code for the bank branch.

Example request

{
  "account_number": "35384249369",
  "ifsc_code": "SBIN0008042"
}

Response

Verification completed. Check status and error_code for the business result.

OR

Example response

{
  "status": "success",
  "message": "Bank account verified successfully.",
  "data": {
    "account_status": "VALID",
    "account_holder_name": "Mr. Example Name",
    "account_ifsc": "SBIN0008042",
    "extras": {
      "bank_name": "STATE BANK OF INDIA",
      "branch": "AFS JALAHALLI EAST",
      "city": "BANGALORE",
      "state": "KARNATAKA",
      "account_status_code": "ACCOUNT_IS_VALID"
    }
  },
  "tranx_id": "00000000-0000-0000-0000-000000000000",
  "timestamp": "2026-05-08T00:00:00.000000+00:00",
  "chargeble": "true",
  "user_consent": "true"
}