Use name enquiry to confirm the account name attached to a bank account before creating a beneficiary or initiating a transfer.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/va/transfer/name-enquiry?bankCode=000014&accountNumber=0123456789&currency=NGN

Query Parameters

Field	Data Type	Required	Description
bankCode	string	Yes	Bank code returned from the List VA Banks endpoint.
accountNumber	string	Yes	Recipient bank account number.
currency	string	Yes	Use `NGN`. The VA transfer rail currently supports NGN.

If the API call is successful, Kyshi returns the resolved account details.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "accountName": "FEMI ZACK",
    "accountNumber": "0123456789",
    "bankCode": "000014",
    "bankName": "Access Bank",
    "bvn": "",
    "nameEnqRef": "SESSION_123456789"
  }
}

Notes

Use the returned account details when creating a VA beneficiary.
If the response includes nameEnqRef, pass it as nameEnqRef when creating the beneficiary.