House Address Verification Integration Guide

Last updated Jun 5th, 2024


The House Address Verification service allows you to verify house addresses and retrieve associated information. This guide will walk you through the process of integrating this functionality into your application, enabling you to perform accurate and efficient address verification.



To get started, please ensure to:

Integration Steps

Step 1: Make a Verification Request

To verify a house address, send a POST request to the following endpoint:



Request Body Parameters

  • meter_number (required): Provide the meter number associated with the address.
  • address (required): Provide a valid house address for verification.

Include these two parameters in the request body to specify the meter number and house address for verification.

Request Headers

Include the following header in your request for authentication:

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

cURL Sample Request


curl -X POST \
  -H "Content-Type: application/json" \
  -H "mono-sec-key: YOUR_MONO_SECRET_KEY" \
  -d '{
    "meter_number": "METER_NUMBER",
    "address": "VALID_HOUSE_ADDRESS"
  }' \

Step 2: Process the Response

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


  "status": "successful",
  "message": "Address successfully verified.",
  "timestamp": "2024-02-28T15:00:20.917Z",
  "data": {
    "verified": true,
    "house_address": "OBA-AKRAN IKEJA LAGOS",
    "house_owner": "SAMUEL OLAMIDE",
    "confidence_level": 1, // or 0
    "disco_code": "IKEJA"
Confidence Level Response

Confidence Level Response

Please be aware that the confidence_level parameter can only return one of two values:

0- Indicates no match.
1 - Indicates a match has been found.

The response above contains information about the verified status, house address, house owner's name, confidence level, and DISCO code associated with the verified address.

Did this page help you?