Digital Address Verification Service

Digital Address Verification is used to verify the address of a candidate using the last address the candidate purchased utilities for.

Digital Address Verification

POST {{baseurl}} /v2/api/digital-addresses/lookup

Headers

Name	Type	Description
token	String	API secret token

Request Body

Name	Type	Description
phone*	String	Phone number of candidate
consent*	Boolean	Indicate subject has given consent. Must be true

Digital Address Verification Sample Request

{
    "phone": "08000000000",
    "consent": true
}

Found Response

{
"success": true,
"statusCode": 200,
"message": "Address verification request successful!",
"data": {
    "_id": "6452959fbcae029b5908b26d",
    "parentId": "628b38f03ae28a14f52d4bf7",
    "businessType": "organization",
    "businessId": "6401c96e055bc4df85ac7753",
    "userId": "6401c96f055bc49bdaac7755",
    "fullName": "Solomon Olaleye",
    "phoneNumber": "08000000000",
    "addresses": [
        {
            "reference": "88888888880",
            "address": "Fake Address, Fake City, Fake State, Fake Country",
            "facility": "PREPAID_METER",
            "owner": "Fake Name",
            "lastUsedOn": "2023-04-28T16:55:38.000Z"
        },
        {
            "reference": "12345678910",
            "address": "Fake Address, Fake City, Fake State, Fake Country",
            "facility": "PREPAID_METER",
            "owner": "Fake Name",
            "lastUsedOn": "2023-05-03T11:50:42.000Z"
        }
    ],
    "status": "found",
    "reasons": null,
    "subjectConsent": "true",
    "type": "digital_address",
    "reportId": "645295a1bcae029b5908b26e",
    "metadata": {},
    "apiVersion": "v2",
    "requestedById": "6401c96f055bc49bdaac7755",
    "requestedAt": "Wed May 03 2023 18:10:57 GMT+0100 (West Africa Standard Time)",
    "country": "NG",
    "createdAt": "2023-05-03T17:10:57.187Z",
    "lastModifiedAt": "2023-05-03T17:10:57.187Z",
    "requestedBy": {
        "firstName": "Prosper",
        "lastName": "Erawuvieke",
        "id": "6401c96f055bc49bdaac7755"
    }
},
"links": []
}

Not Found Response