Skip to main content

Account Name Enquiry

Overview​

Validate a Nigerian bank account number by retrieving the associated account name before creating a beneficiary or sending a payout.

This pre-payment validation eliminates transfer failures due to incorrect account details and ensures regulatory compliance.

Resource Access​

  • HTTP Method: POST
  • Endpoint: /profile/v2.1/name-enquiry
  • Authentication: Bearer token required (Authorization: Bearer {access_token})

Request Headers​

HeaderValueRequiredDescription
Acceptapplication/jsonYesResponse content type
AuthorizationBearer {access_token}YesBearer token for authentication
Content-Typeapplication/jsonYesRequest body content type
x-api-keystringNoOptional API key

Request Body​

{
"bankCountry": "NG",
"bankCode": "058",
"accountNumber": "0123456789"
}

Request Fields​

FieldTypeRequiredDescription
bankCountrystringYesCountry code where the bank is located (NG).
bankCodestringYesFinancial institution code or routing identifier (e.g. 058 for GTBank).
accountNumberstringYesDestination bank account number to resolve.

Response​

Success Response (200 OK)​

{
"bankCountry": "NG",
"bankCode": "058",
"accountNumber": "0123456789",
"accountName": "JOHN DOE ENTERPRISES"
}

Response Fields​

FieldTypeDescription
bankCountrystringCountry code of the queried bank (NG).
bankCodestringBank code queried.
accountNumberstringVerified account number.
accountNamestringOfficial registered name of the account holder.

Error Responses​

  • 400 Bad Request: Invalid bank code or malformed account number.
  • 401 Unauthorized: Missing or expired Bearer token.
  • 404 Not Found: Account number could not be resolved with the specified financial institution.
  • 500 Internal Server Error: Downstream banking switch error.

Code Examples​

cURL​

curl -X POST "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/name-enquiry" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"bankCountry": "NG",
"bankCode": "058",
"accountNumber": "0123456789"
}'

Python​

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/name-enquiry"
headers = {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json"
}
payload = {
"bankCountry": "NG",
"bankCode": "058",
"accountNumber": "0123456789"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
print("Account Name:", data.get("accountName"))

JavaScript / Node.js​

const response = await fetch("https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/name-enquiry", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json"
},
body: JSON.stringify({
bankCountry: "NG",
bankCode: "058",
accountNumber: "0123456789"
})
});

const result = await response.json();
console.log("Account Holder:", result.accountName);

Interactive API Explorer​