Skip to main content
POST
/
api
/
onboarding
/
nigeria_kyc
/
nuban
NUBAN Verification
curl --request POST \
  --url https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nuban/ \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "account_number": "0123456789",
  "bank_code": "044"
}
'
{
  "status": "failed",
  "data": [
    "<unknown>"
  ],
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.smartcomply.com/llms.txt

Use this file to discover all available pages before exploring further.

The NUBAN endpoint verifies a Nigerian Uniform Bank Account Number (NUBAN) and returns the account name and bank associated with it. Use this for bank account ownership verification during onboarding or payment flows.

​
Endpoint

POST /api/onboarding/nigeria_kyc/nuban/

​
Request

​
Headers

HeaderValueRequired
x-access-tokenYour API secret keyYes
Content-Typeapplication/jsonYes

​
Body Parameters

ParameterTypeRequiredDescription
account_numberstringYesThe 10-digit NUBAN account number
bank_codestringYesThe 3–6 digit bank code (see list below)

​
Example

curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nuban/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_number": "0768540312", "bank_code": "035"}'

​
Bank Codes Reference

BankCode
Access Bank044
Citibank Nigeria023
ECOBANK050
FCMB214
Fidelity Bank070
First Bank of Nigeria011
GTBank058
Heritage Bank030
JAIZ Bank301
Kuda Microfinance Bank50211
Lotus Bank303
Moniepoint Microfinance Bank50563
Opay999992
Palmpay999111
Polaris Bank076
Providus Bank101
Stanbic IBTC Bank221
Standard Chartered Bank068
Sterling Bank232
TAJBank302
Union Bank of Nigeria032
United Bank For Africa033
Unity Bank215
Wema Bank035
Zenith Bank057

​
Response

​
200 OK

FieldTypeDescription
data.bank_idintegerInternal bank identifier
data.account_namestringRegistered account holder name
data.account_numberstringAccount number that was queried
{
  "status": "success",
  "data": {
    "bank_id": 11,
    "account_name": "STEPHEN BADMUS",
    "account_number": "0768540312"
  },
  "message": "Nuban details retrieved successfully"
}

​
400 Bad Request

{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}

​
401 Unauthorized

{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}

Authorizations

​
x-access-token
string
header
required

Your Adhere API secret key

Body

application/json
​
account_number
string
required

10-digit account number

Example:

"0123456789"

​
bank_code
string
required
Example:

"044"

Response

NUBAN verified