Lookup NUBAN

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

Request

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

Headers

ParameterTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic 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'