Mono Lookup is a group of APIs that makes it possible for partners to look up customers’ account information using their BVN, NIN, or bank account number.
With the Lookup API, you can also carry out Know-Your-Customer (KYC) and Know-Your-Business (KYB) activities. Mono Lookup simply fetches information from a valid, government-issued ID number.
N.B. You will be required to authorize all API calls with your Mono Secret Key. This article will show you how to find your secret Key.
Types of Lookup
BVN Lookup (Identity and Bank account details)
Account Lookup
CAC Lookup (Business Name, Shareholder details, Previous Address, Change of Name, Secretary and Directors)
Address Lookup
International passport Lookup
NIN (National Identification Number) Lookup
TIN (Tax Identification Number) Lookup
Driver's License Lookup
BVN Lookup (Identity details)
This endpoint is used for verifying users using their Bank Verification Number. There are three stages for the verification process:
Initiate Lookup
Verify OTP
Fetch Details
Initiating this endpoint requires:
The BVN of the user
Session ID
OTP
Your Mono Secret Key
Initiate Lookup
The Response is similar to the message below
Verify OTP
The Response is similar to the message below
Fetch Details
The Response is similar to the message below:
BVN Lookup (Bank account details)
This endpoint is used for retrieving all accounts connected to a BVN.
There are three stages for the verification process:
Initiate Lookup
Verify OTP
Fetch Details
For this, you simply need:
The BVN of the user
Scope (bank_accounts)
Session ID
OTP
Your Mono Secret Key
Initiate Lookup
The Response is similar to the message below
Verify OTP
The Response is similar to the message below
Fetch Details
The Response is similar to the message below:
This Endpoint is used to verify the existence of an account, whether a business or individual account. Initiating this endpoint requires:
An Account Number
nip_code: This can be retrieved from our NIP bank listing api
Your Mono Secret Key
The Response is similar to the message below
CAC Lookup (Business Name)
This Endpoint is used to verify the existence of a business name.
Initiating this endpoint requires:
A Business Name
Your Mono Secret Key
The Response is similar to the message below
CAC Lookup(Shareholder details)
This Endpoint is used to retrieve the shareholder information of a business.
Initiating this endpoint requires:
A CAC ID
Your Mono Secret Key
The Response is similar to the message below
CAC Lookup(Previous Address)
This Endpoint is used to check previous company address.
Initiating this endpoint requires:
A CAC ID
Your Mono Secret Key
The Response is similar to the message below
CAC Lookup(Change of Name)
This Endpoint is used to check the history of a business' name change
Initiating this endpoint requires:
A CAC ID
Your Mono Secret Key
The Response is similar to the message below
CAC Lookup(Secretary)
This Endpoint is used to search for the company secretary
Initiating this endpoint requires:
A CAC ID
Your Mono Secret Key
The Response is similar to the message below
CAC Lookup(Directors)
This Endpoint is used to search for the company directors
Initiating this endpoint requires:
A CAC ID
Your Mono Secret Key
The Response is similar to the message below
This endpoint is used to confirm the validity of house addresses and the house owners, ensuring that the provided address corresponds to a real location.
Initiating this endpoint requires:
Electricity meter_number
address
Your Mono Secret Key
The Response is similar to the message below
This endpoint is used to validate the authenticity and retrieve comprehensive details associated with the National Identification Number (NIN) of your customer.
Initiating this endpoint requires:
NIN
Your Mono Secret Key
The Response is similar to the message below
This endpoint is used to verify the tax identification number of an entity and obtain critical tax-related information.
Initiating this endpoint requires:
Tax identification number
Channel
Your Mono Secret Key
The Response is similar to the message below
This endpoint is used to validate and retrieve details from the international passport documents of your users.
Initiating this endpoint requires:
passport_number
last_name
Your Mono Secret Key
The Response is similar to the message below
This endpoint is used for verifying users using their driver's license number. Initiating this endpoint requires:
The license number of the user
The date of birth
The first and last name
Your Mono Secret Key
The Response is similar to the message below
This endpoint is used for retrieving a customer credit history directly from the two largest credit bureaus in Nigeria- Credit Bureau Limited (crc) and First Central Credit Bureau (xds) using only their BVN. This retrieval is subject to customer consent. Initiating this endpoint requires:
The BVN of the user
The Credit provider (crc or xds)
Your Mono Secret Key
The Response is similar to the message below
