Integration Guide

Integrate our seamless account number lookup into your application.


The Account Number 2.0 lookup service allows you to retrieve information associated with a bank account number. Follow the steps below to integrate this functionality into your application.


To get started, please ensure to:

  • Sign up on the Mono Dashboard
  • Create an App and fetch the generated Secret Key

Step 1: Make a Lookup Request

Send a POST request to the following endpoint to initiate the account number lookup:


Request Body Parameters

  • bank_code (required): The bank code associated with the account.
  • account_number (required): The 10-digit bank account number to lookup.

Include these two parameters in the request body to specify the bank and account number for the lookup.

Request Headers

Include the following header in your request:

  • mono-sec-key (required): Your Mono secret key for authentication.

cURL Sample Request

curl -X POST \
  -H "Content-Type: application/json" \
  -H "mono-sec-key: YOUR_MONO_SECRET_KEY" \
  -d '{
    "bank_code": "000013",
    "account_number": "0000000"
  }' \

Step 2: Process the Response

If the request is successful, you will receive the following response:

  "status": "successful",
  "data": {
    "account_number": "0000000",
    "bvn": "0000000000",
    "bank": {
      "name": "GTBank",
      "code": "000013"

The response contains detailed information about the account, including the account holder's name, account number, associated BVN, and bank details such as the bank name and code.