Skip to main content
Resolve a bank account number to its registered account name before sending funds. Always perform an inquiry first to confirm you have the correct recipient details.

​
Authentication

x-api-key: your_api_key
x-api-secret: your_api_secret

​
Endpoint

This endpoint accepts both GET (query parameters) and POST (JSON body) requests. 
GET  https://api.hyparrow.com/api/v1/transfers/account-inquiry?accountNumber={}&bankCode={}
POST https://api.hyparrow.com/api/v1/transfers/account-inquiry

​
Parameters

​
accountNumber
string
required
The recipient’s bank account number (typically 10 digits for Nigerian accounts).
​
bankCode
string
required
The recipient bank’s code. Obtain this from the List Banks endpoint.
When using POST, send these same fields as a JSON body instead of query parameters.

​
Response

​
success
boolean
true when the account is found and the name is resolved.
​
data
object
Account details returned by the bank.

​
Examples

curl -X GET "https://api.hyparrow.com/api/v1/transfers/account-inquiry?accountNumber=0123456789&bankCode=058" \
  -H "x-api-key: your_api_key" \
  -H "x-api-secret: your_api_secret"

​
Success response

{
  "success": true,
  "data": {
    "accountName": "ADA CHIOMA OKAFOR",
    "accountNumber": "0123456789",
    "bankCode": "058"
  }
}

​
Error response

{
  "success": false,
  "error": "Account inquiry failed: account number not found",
  "data": null
}
Always use the resolved accountName to confirm the correct recipient with your user before calling Send Transfer.