mono-logo

House Address Verification Integration Guide

Last updated Jun 5th, 2024

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

Prerequisites

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

1
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

Request

12345678
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:

Request

123456789101112
{
  "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?