Lookup NUBAN KYC Status

Check the KYC status of the owner of a Nigerian bank account (NUBAN). Returns tier and compliance status for the account holder.

Request

[GET]

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

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameters

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

The bank codes can be gotten from this endpoint.

Sample response

Response

{
  "entity": {
    "account_currency": "NGN",
    "account_name": "MICHEAL ADEOSUN GABRIEL",
    "account_number": "3046***407",
    "bank": "GTB",
    "kyc_status": "2",
    "first_name": "John",
    "identity_number": "*********556",
    "identity_type": "BVN",
    "last_name": "ADEOSUN",
    "other_names": "GABRIEL",
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the KYC status verification response data
entity.account_currency	string	Currency of the bank account (e.g., NGN)
entity.account_name	string	Full name on the bank account
entity.account_number	string	Masked bank account number
entity.bank	string	Short name or code of the bank
entity.kyc_status	string	KYC tier/compliance status of the account holder
entity.first_name	string	First name of the account holder
entity.identity_number	string	Masked identity number linked to the account
entity.identity_type	string	Type of identity document linked (e.g., BVN)
entity.last_name	string	Last name of the account holder
entity.other_names	string	Other names (middle name) of the account holder

Test Credentials for Sandbox

Kindly use this Test NUBAN in sandbox Environment

Account Number = 3046507407 Bank Code = 011