House Address Verification 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

To get started, please ensure to:

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

Integration Steps

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.",
  "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

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.