Physical Address Verification

Be compliant and secure with our CBN-approved Physical Address Verification service, powered by QoreID’s nationwide last-mile logistics network. With access to over 30,000 field agents across Nigeria, we verify residential and business addresses within 24–48 hours, providing fast, reliable, and audit-ready verification results. 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
originalRequesterName (OPTIONAL)	string	Original requester name (main requester company name)
allowRevisit (OPTIONAL)	boolean	Allow Revisit (Not a duplicate)
applicant.firstname (REQUIRED)	string	Applicant First Name
applicant.lastname (REQUIRED)	string	Applicant Last Name
applicant.alias (OPTIONAL)	string	Applicant Alias
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"
      }
    }