NEWIntroducing the new Mono Dashboard
Mono Blog

Introducing the Mono Credit History Lookup endpoint

Feb 05, 2024Product

Share article

We're excited to share the Credit History Lookup endpoint, an addition to our Mono Lookup API suite, giving businesses in Nigeria one more modern way to seamlessly assess credit applications. In a growing economy where consumer credit plays a major role, lenders and creditors need to meet a high demand for loans, and while doing so, look out for important lending risk factors. Mono serves many digital lending and financing businesses, and providing infrastructure that ensures that they can meet the needs of their borrowers while lending in a smart, low-risk, and data-driven way, is our top priority.

Features of the Credit History Lookup Endpoint

The credit history API relies on the BVN data point to give lenders access to credit history data from two of the largest credit bureaus in Nigeria.

Using the BVN which a potential borrower/customer has consented to share with you, your business can make calls to the Mono Credit History endpoint to retrieve:

  • Identity details such as the user's full name and contact details

  • All details of recent and historical (up to 5 years) credit facilities accessed, such as the name of the institutions they have borrowed from, the amount and tenor of each facility, and the opening and expected closing dates.

  • All statuses on credit facilities accessed, showing which loans are performing/open, closed, and non-performing.

The benefits of using the Mono Credit History Lookup endpoint

  • Improved borrower profiling - The Credit History API can supercharge your existing underwriting and borrower profiling process, allowing you to understand how a user borrows and repays, spot any patterns in lending behaviour and apply your existing loan decision framework more confidently

  • Faster loan processing - You can deliver lending decisions to potential borrowers in minutes, reducing the chances of drop-offs.

  • Credit risk reduction - You can adjust loan offerings, and accept or even decline loan applications from the robust borrowing history you can access from the Credit History lookup API, to reduce the risk of lending to over-committed or bad borrowers.

  • Quick integration - The Credit History Lookup endpoint is developer-friendly, quick and easy to integrate. You can get started in just minutes.

  • Verified borrower history source - The Credit History Lookup API instantly retrieves accurate, up-to-date, and historical lending information, each borrower, going back up to 5 years, directly from two of the largest credit bureaus in Nigeria. Here's a sample response showing robust information that is returned when you call the endpoint.

    Mono Credit History Lookup endpoint

How to get started:

If you already have a Mono account,

  • Log on to your Mono dashboard

  • Create an app and set the scope to Lookup

  • Grab the app's secret key

  • Make a call to the endpoint using your customer's BVN and indicating what institution you'd like to retrieve borrowing history from

    Here's a guide in our API documentation to walk you through this integration, calling this endpoint, and a sample of the expected response you will receive.

If you're using Mono for the first time

  • Create a Mono account here

  • Submit all required business documents and request for activation

  • Create an app on your dashboard and set the product scope to 'Lookup'

  • Grab the app's secret key

  • Follow our API documentation to walk you through the steps.

  • Make a call to the endpoint using your customer's BVN and indicating what institution you'd like to retrieve borrowing history from

Questions you might have about the Mono Credit History Lookup endpoint and answers to them

Who can use the Mono Credit History lookup endpoint?

If you're a Nigerian business in the credit and financing industry (digital lenders, Buy Now Pay Later, Credit Unions, etc), looking to improve your underwriting process, power your lending with data-driven decisions, and reduce lending risk, you can use the Mono Credit History API.

How much does it cost to use the Mono Credit History lookup endpoint?

It costs ₦300 per API call to either of the institutions, and ₦600 per API call to retrieve information from both institutions in one call.

Like what you read?

Become a subscriber and receive notifications about blog posts, company events and announcements, products and more.

Next Read

Mar 18, 2025Product

Differences between Mono DirectPay and Mono Direct Debit

Read the story
Differences between Mono DirectPay and Mono Direct Debit
Aug 13, 2024Product

The Mono Income API v2 is live!

Read the story
The Mono Income API v2 is live!
Aug 1, 2024Product

Introducing: The Mono Creditworthiness API

Read the story
Introducing: The Mono Creditworthiness API

Start building with Mono today

© Mono Technologies Nigeria Limited

trust mark NIGtrust mark QR Codeiso-iec27001iso-iec27002iso-iec27003

Disclaimer:
The information provided on this website is intended for general informational purposes only and does not constitute financial, legal, or professional advice. While we strive to ensure that the content presented is accurate and up-to-date, we make no representations or warranties of any kind, express or implied, about the completeness, accuracy, reliability, suitability, or availability with respect to the website or the information, products, services, or related graphics contained on the website for any purpose. Any reliance you place on such information is therefore strictly at your own risk.

Our platform is designed to ensure secure access to financial accounts for the purposes of retrieving statements, monitoring transactions in real-time, and verifying customer identities. Despite our use of advanced security protocols to protect sensitive information, we cannot guarantee the absolute security of your data. Users are advised to independently verify the accuracy and completeness of all information obtained through our services before making any financial or business decisions.

Furthermore, while we endeavor to keep the website running smoothly, we take no responsibility for, and will not be liable for, the website being temporarily unavailable due to technical issues beyond our control. In no event will we be liable for any loss or damage including without limitation, indirect or consequential loss or damage, or any loss or damage whatsoever arising from loss of data or profits arising out of, or in connection with, the use of this website.

This website may contain links to other websites which are not under the control of our company. We have no control over the nature, content, and availability of those sites. The inclusion of any links does not necessarily imply a recommendation or endorse the views expressed within them.

By using this website, you agree to these terms and acknowledge that any reliance on the information provided here is at your own risk. If you have any questions regarding this disclaimer or the website's content, please contact us directly.