Integration Guide

Overview

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.

Prerequisites

Before you begin integrating the House Address Verification service, make sure you have the following:

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

Step 1: Make a Verification Request

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

POST https://api.withmono.com/v3/lookup/address

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"
  }' \
  https://api.withmono.com/v3/lookup/address

Step 2: Process the Response

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

{
  "status": "successful",
  "message": "Address successfully verified.",
  "data": {
    "verified": true,
    "house_address": "IKEJA UNDER BRIDGE LAGOS",
    "house_owner": "ADAM SMITH",
    "confidence_level": 50,
    "disco_code": "IKEJA"
  }
}

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