Skip to main content
NUBAN (Nigerian Uniform Bank Account Number) lookup endpoints let you resolve bank account ownership before initiating transfers or collecting payments. Each call consumes your KYC balance or quota.

​
Authentication

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

​
Lookup bank account

Resolve the owner of an account number without specifying a bank. The service checks across multiple banks and returns the account name when found. 
POST /api/v1/kyc/nuban/lookup

​
Request body

​
accountNumber
string
required
The 10-digit NUBAN account number to look up.

​
Example request

curl --request POST \
  --url https://api.hyparrow.com/api/v1/kyc/nuban/lookup \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-api-secret: your_api_secret' \
  --data '{ "accountNumber": "0123456789" }'

​
Example response

200 OK
{
  "success": true,
  "data": {
    "accountNumber": "0123456789",
    "accountName": "JANE DOE",
    "bankName": "GTBank",
    "bankCode": "000013"
  }
}

​
Response fields

​
data.accountNumber
string
The account number that was queried.
​
data.accountName
string
The full name of the account holder as registered with the bank.
​
data.bankName
string
The name of the bank where the account is held.
​
data.bankCode
string
The CBN bank code for the resolved bank.

​
Lookup with specific bank

Resolve the owner of an account number at a specific bank using the bank’s CBN code. Use this when you already know which bank the account belongs to — it returns faster and more accurate results. 
POST /api/v1/kyc/nuban/lookup-with-bank

​
Request body

​
accountNumber
string
required
The 10-digit NUBAN account number.
​
bankCode
string
required
The CBN bank code of the bank to look up the account at. For example, "000013" for GTBank or "000014" for Access Bank.

​
Example request

curl --request POST \
  --url https://api.hyparrow.com/api/v1/kyc/nuban/lookup-with-bank \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-api-secret: your_api_secret' \
  --data '{
    "accountNumber": "0123456789",
    "bankCode": "000013"
  }'

​
Example response

200 OK
{
  "success": true,
  "data": {
    "accountNumber": "0123456789",
    "accountName": "JANE DOE",
    "bankName": "GTBank",
    "bankCode": "000013"
  }
}

​
Guess banks

Identify which Nigerian banks a given account number is likely to belong to, based on the NUBAN algorithm. Returns a list of probable banks without performing a live account name enquiry. 
POST /api/v1/kyc/nuban/guess-banks

​
Request body

​
accountNumber
string
required
The 10-digit NUBAN account number to analyse.

​
Example request

curl --request POST \
  --url https://api.hyparrow.com/api/v1/kyc/nuban/guess-banks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-api-secret: your_api_secret' \
  --data '{ "accountNumber": "0123456789" }'

​
Example response

200 OK
{
  "success": true,
  "data": {
    "accountNumber": "0123456789",
    "possibleBanks": [
      {
        "bankName": "GTBank",
        "bankCode": "000013",
        "confidence": "high"
      },
      {
        "bankName": "First Bank",
        "bankCode": "000016",
        "confidence": "medium"
      }
    ]
  }
}

​
Response fields

​
data.possibleBanks
array
Array of banks that the account number might belong to.