Use name enquiry to verify a beneficiary bank account before creating a beneficiary or initiating a transfer.

-H "x-api-key: your_secret_key"

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

Query Parameters

Field	Data Type	Required	Description
bankCode	string	Yes	Bank code returned from the Banks endpoint.
accountNumber	string	Yes	Beneficiary account number.
currency	string	Yes	Payout currency. Supported payout currencies include `NGN`, `GHS`, and `KES`.

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

Notes

Name enquiry availability depends on the payout currency and provider.
KES payouts may require you to provide beneficiary account details directly when creating the beneficiary.
If the response includes nameEnqRef, pass it when creating the beneficiary.