Physical Address Verification

Be compliant and secure with our CBN compliant Physical address verifications using our last mile logistics engine.

We have over 30k agents across the country to verify addresses within 24-48 hours. . To conduct a live test

{{baseUrl}}/v1/addresses

Request Body

Parameters

Type

Description

customerReference (REQUIRED)

string

Customer's Reference

street
(REQUIRED)

string

Address street to be verified

lgaName
(REQUIRED)

string

Local govt area to be verified

stateName
(REQUIRED)

string

Address State Name

landmark
(OPTIONAL)

string

Address landmark to be verified

city
(REQUIRED)

string

Address city to be verified

applicant.firstname
(REQUIRED)

string

Applicant First Name

applicant.lastname
(REQUIRED)

string

Applicant Last Name

applicant.phone
(REQUIRED)

string

Applicant Phone

applicant.dob
(OPTIONAL)

dateString

Applicant Date of Birth (YYYY-MM-DD)

applicant.gender
(OPTIONAL)

string

Gender

applicant.idType
(OPTIONAL)

string

Applicant Identification Type

applicant.idNumber
(OPTIONAL)

string

Applicant Identification Number

Response Sample

{
    "id": 51,
    "customerReference": "adrsdtes",
    "applicant": {
        "createdAt": "2022-11-02T21:38:46.000Z",
        "updatedAt": "2022-11-02T21:38:46.000Z",
        "id": 23,
        "firstname": "Kolade",
        "middlename": "toyosi",
        "lastname": "Alade",
        "gender": "female",
        "phone": "+2348111111111",
        "dob": "2022-09-14"
    },
    "summary": {
        "address_check": "IN_PROGRESS"
    },
    "status": {
        "status": "IN_PROGRESS",
        "subStatus": "IN PROGRESS",
        "state": "IN_PROGRESS"
    },
    "address": {
        "verificationTypeCode": "address",
        "organisationId": 86923,
        "requestedAt": "2022-11-02T21:38:46.000Z",
        "requestSource": "api",
        "archived": false,
        "stateId": 25,
        "stateName": "Lagos",
        "lgaId": 515,
        "lgaName": "Mushin",
        "location": {
            "city": "mushin",
            "initialLatitude": 6.52626,
            "initialLongitude": 3.35714,
            "landmark": "mushin",
            "latitude": 6.52626,
            "lgaName": "Mushin",
            "locationUrl": "https://maps.google.com/?q=6.52626,3.35714",
            "longitude": 3.35714,
            "stateName": "Lagos",
            "street": "13,adetobi kofoworola street ajayi"
        },
        "isVague": false,
        "customerReference": "adrsdtes",
        "paymentMethodCode": "standard",
        "price": 0,
        "updatedAt": "2022-11-02T21:38:46.000Z",
        "status": {
            "status": "IN_PROGRESS",
            "subStatus": "IN PROGRESS",
            "state": "IN_PROGRESS"
        }
    },
    "duplicateRequest": false
}
   "body": {
      "event": "address",
      "event_type": "verification_completed",
      "data": {
        "id": 41619,
        "summary": null,
        "customerReference": "yr67irhejer8",
        "address": {
          "id": 41619,
          "verificationTypeCode": "address",
          "organisationId": 8,
          "userId": 8,
          "approvedAt": "2024-10-23T12:03:52.000Z",
          "requestedAt": "2024-07-24T15:11:56.000Z",
          "identityVerificationId": null,
          "requestSource": "qoreid",
          "archived": false,
          "apiReference": null,
          "stateId": 28,
          "stateName": "Ogun",
          "lgaId": 568,
          "lgaName": "Ijebu Ode",
          "applicationId": 315,
          "neighbor": {
            "comment": "f",
            "firstname": null,
            "isApplicantKnown": null,
            "isAvailable": false,
            "lastname": null,
            "phone": null
          },
          "countryName": "Nigeria",
          "isLive": true,
          "isDuplicate": false,
          "location": {
            "city": "Ijebu",
            "initialLatitude": 6.8299846,
            "initialLongitude": 3.9164585,
            "isAvailableOnSite": false,
            "landmark": "Awujale Palace",
            "latitude": 7.387476700000001,
            "lgaName": "Ijebu Ode",
            "locationUrl": "https://maps.google.com/?q=6.8299846,3.9164585",
            "longitude": 3.87948,
            "stateName": "Ogun",
            "street": "19 Oreagba Street"
          },
          "addressBasic": {
            "addressType": "",
            "buildingColor": "Brown",
            "buildingColour": null,
            "buildingPurpose": "Residential",
            "buildingStatus": "Completed and Painted",
            "buildingType": "Multi-storey Building",
            "hasFence": null,
            "hasGate": null,
            "hasGateAndFence": true
          },
          "business": {
            "area": null,
            "businessName": null,
            "businessType": null,
            "canContactPoc": null,
            "ceoName": null,
            "hasSignage": null,
            "id": null,
            "industry": null,
            "isKnown": null,
            "isOwnerKnown": null,
            "isRegistered": null,
            "name": null,
            "nameFound": null,
            "ownerVisitsFrequently": null,
            "personOfContact": null,
            "personOfContactRole": null,
            "rcNumber": null,
            "size": null,
            "staffOnSite": null,
            "staffStrength": null,
            "type": null
          },
          "isVague": false,
          "customerReference": "yr67irhejer8",
          "paymentMethodCode": "standard",
          "applicant": {
            "organisationId": 8,
            "applicantId": null,
            "customerReference": null,
            "firstname": "Abibat",
            "middlename": "Yaya",
            "lastname": "Esther",
            "phone": "+2347064738813",
            "email": null,
            "dob": null,
            "gender": null,
            "maritalStatus": null,
            "photo": null,
            "imageId": null,
            "faceId": null
          },
          "price": 5000,
          "agentComment": "f",
          "agentSubmittedAt": "2024-10-23T11:58:20.000Z",
          "rejectedAt": null,
          "interiorPhotos": {},
          "exteriorPhotos": {
             "photo1": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy00MjQ3MTE3LXBob3RvMS00MDA0NjEtNDk0NjU4NTEiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTcyOTY4ODg1OSwiZXhwIjoxNzYxMjI0ODU5LCJpc3MiOiJxb3JlLWlkIn0.Ogha9bcBjyabElWnlQ5Iu-4jkrmmVCCL-SwZ_YFemMo",
             "photo2": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy00MjQ3MTE3LXBob3RvMi00MDA0NjEtODM5NDQ0MjciLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTcyOTY4ODg1OSwiZXhwIjoxNzYxMjI0ODU5LCJpc3MiOiJxb3JlLWlkIn0.YS-S5mQQ8mG-LuO9C7_P2pAiba0CykE7oRl5EFuragw",
             "photo3": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy00MjQ3MTE3LXBob3RvMy00MDA0NjEtNTE4NzE0MDUiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTcyOTY4ODg1OSwiZXhwIjoxNzYxMjI0ODU5LCJpc3MiOiJxb3JlLWlkIn0.6RK4Esrsn-dI9CKo8_dglEhhALIEtpLgTUalXHl4bxc"
          },
          "extraPhotos": {},
          "status": {
            "status": "VERIFIED",
            "subStatus": "VERIFIED",
            "state": "COMPLETE"
          }
        },
      "reportURL": "https://media.qoreid.com/v1/report/address/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ2ZXJpZmljYXRpb25JZCI6NDI0NzExNywiYWNjb3VudElkIjo4NjkyMywiYXBwbGljYXRpb25JZCI6MTMxLCJpc0xpdmUiOnRydWUsInByb2R1Y3RDb2RlIjoiIiwidmVyaWZpY2F0aW9uVHlwZUNvZGUiOiJhZGRyZXNzIiwidG9rZW4iOiIiLCJpYXQiOjE3Mjk2ODg4NTksImV4cCI6MTcyOTg2MTY1OSwiaXNzIjoicW9yZS1pZCJ9.c5PJXyKkJuCqBgeqvDM-CWDranuD0xgd0LbIs-C9DlM"
      }
    }