Lookup NUBAN

The Lookup NUBAN (Nigeria Uniform Bank Account Number) endpoint provides information of users' account numbers

Request

{{baseUrl}}/api/v1/kyc/nuban

Headers

Parameter	Type	Description
AppId	string	you would need to create an app to get your app ID
Authorization	string	public secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query Parameters

Parameter	Type	Description
account_number *	string	Bank account number	required
bank_code *	integer	Bank Code	required

📘
Note
The bank codes can be gotten from this endpoint

Response Sample

{
  "entity": {
    "account_currency": "566",
    "account_name": "MICHEAL ADEOSUN GABRIEL",
    "account_number": "3046***407",
    "account_type": "10",
    "address_1": ".",
    "address_2": "",
    "city": "LAGOS",
    "country_code": "",
    "country_of_birth": "",
    "country_of_issue": "",
    "dob": "10/06/1982",
    "expiry_date": "",
    "first_name": "MICHAEL",
    "identity_number": "222******556",
    "identity_type": "BVN",
    "last_name": "ADEOSUN",
    "nationality": "",
    "other_names": "GABRIEL",
    "phone": "2348****77844",
    "postal_code": "234",
    "state_code": "LAGOS"
  }
}

curl -L -X GET '{{baseUrl}}/api/v1/kyc/nuban?bank_code={{bank_code}}&account_number={{account_number}}' \
-H 'Content-Type: application/json' \
-H 'Authorization: SECRET_KEY'

Updated 7 months ago