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

Header	Value	Required	Description
Accept	application/json	Yes	Response content type
Authorization	Bearer {access_token}	Yes	Bearer token for authentication
Content-Type	application/json	Yes	Request body content type
x-api-key	string	No	Optional API key

Request Body

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

Request Fields

Field	Type	Required	Description
bankCountry	string	Yes	Country code where the bank is located (NG).
bankCode	string	Yes	Financial institution code or routing identifier (e.g. 058 for GTBank).
accountNumber	string	Yes	Destination bank account number to resolve.

Response

Success Response (200 OK)

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

Response Fields

Field	Type	Description
bankCountry	string	Country code of the queried bank (NG).
bankCode	string	Bank code queried.
accountNumber	string	Verified account number.
accountName	string	Official 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