Beneficiary validation

Validate Account

Request

Check that a beneficiary bank account exists and, when a name is supplied, that it matches the account holder. India only (country must be IND).

Security

bearerAuth

Bodyapplication/jsonrequired

countrystring(ApiCountry)required

Destination country. Must be IND — account validation is available for India only, because it is the only corridor with the bank reference data the validation backends need. Any other value is a 400.

Enum:"BGD""IND""PAK""PHL""NPL""EGY""VNM""NGA"

account_numberstring(Account Number)required

Bank account id of the beneficiary. The same value POST /v2/payment takes as beneficiary_account_number.

bank_branch_codestring(Bank Branch Code)required

Indian Financial System Code (IFSC) of the bank branch, e.g. HDFC0001234.

beneficiary_namestring or null(Beneficiary Name)

Any of:

Bank account holder name

string

curl -i -X POST \
  https://docs.leanx.me/_mock/openapi/v2/validate_account \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "country": "BGD",
    "account_number": "string",
    "bank_branch_code": "string",
    "beneficiary_name": "string"
  }'

Responses

Successful Response

Bodyapplication/json

Any of:

account_numberstring(Account Number)required

Bank account id of the beneficiary.

bank_branch_codestring(Bank Branch Code)required

Indian Financial System Code (IFSC) of the bank branch

statusstring(BankAccountStatus)required

Result of a beneficiary account check.

Enum Value	Description
invalid	The account was not found, or is blocked, closed or inactive, or the IFSC code is invalid. Do not send a payment to it.
nre	The account exists and is an Indian NRE (Non-Resident External) account. It passes validation; payments to it are handled under NRE rules.
pending	The check is still running at the provider. This is not a failure: check again later.
valid	The account exists and is active.

namestring or null(Name)

Any of:

string

Response

{
  "account_number": "string",
  "bank_branch_code": "string",
  "status": "valid",
  "name": "string"
}