Integration Guides
Status Page

Physical Address Verification Pro

Physical Address Verification Pro is the enhanced variant of our CBN-approved Physical Address Verification service, powered by QoreID’s nationwide last-mile logistics network. Beyond the standard address check, Pro captures richer applicant-supplied evidence up front — a structured property description, map-confirmed coordinates, and house photos — so our QA team can validate agent submissions against a stronger reference set. With access to over 30,000 field agents across Nigeria, we verify residential and business addresses within 24–48 hours, returning fast, reliable, and audit-ready results.

To conduct a live test

NB: ‎addressExtraData carries the Pro-specific fields (property descriptors, coordinates, and photos). It is required for this API endpoint.

{{baseUrl}}/v1/addresses/pro

Request Body

ParametersTypeDescription
customerReference (REQUIRED)stringCustomer's Reference
street
(REQUIRED)		stringAddress street to be verified
lgaName
(REQUIRED)		stringLocal govt area to be verified
stateName
(REQUIRED)		stringAddress State Name
landmark
(OPTIONAL)		stringAddress landmark to be verified
city
(REQUIRED)		stringAddress city to be verified
originalRequesterName
(OPTIONAL)		stringOriginal requester name
(main requester company name)
allowRevisit
(OPTIONAL)		booleanAllow Revisit (Not a duplicate)
applicant.firstname
(REQUIRED)		stringApplicant First Name
applicant.lastname
(REQUIRED)		stringApplicant Last Name
applicant.alias
(OPTIONAL)		stringApplicant Alias
applicant.phone
(REQUIRED)		stringApplicant Phone
applicant.dob
(OPTIONAL)		dateStringApplicant Date of Birth (YYYY-MM-DD)
applicant.gender
(OPTIONAL)		stringGender
applicant.idType
(OPTIONAL)		stringApplicant Identification Type
applicant.idNumber
(OPTIONAL)		stringApplicant Identification Number
applicant.otherPhone
(OPTIONAL)		stringApplicant Other Phone Number
addressExtraData
(REQUIRED)		objectAdditional details about the address and property.
addressExtraData.houseNumber
(OPTIONAL)		stringHouse number.
addressExtraData.generalDescription
(REQUIRED)		stringFree-text description of the address.
addressExtraData.latitude
(REQUIRED)		numberLatitude of the address.
addressExtraData.longitude
(REQUIRED)		numberLongitude of the address.
addressExtraData.buildingDescription
(REQUIRED)		enum: {Residential, Commercial}Building description.
addressExtraData.hasGateAndFence
(REQUIRED)		booleanWhether the property has both a gate and a fence.
addressExtraData.buildingStatus
(REQUIRED)		enum: {Completed, Painted, Completed and Painted}Building status.
addressExtraData.buildingType
(REQUIRED)		enum: {Multi-story, Flats & Apartment, Bungalow, Office Complex}Building type.
addressExtraData.buildingColour
(REQUIRED)		stringPrimary visible building colour.
addressExtraData.applicantPhoto1
(OPTIONAL)		base64stringBase64-encoded house photo.
addressExtraData.applicantPhoto2
(OPTIONAL)		base64stringBase64-encoded house-number photo.
addressExtraData.applicantPhoto3
(OPTIONAL)		base64stringBase64-encoded nearest-landmark photo.

Response Sample

{
  "id": 1,
  "customerReference": "some-reference",
  "applicant": {
    "organisationId": 1,
    "customerReference": "some-reference",
    "firstname": "Bunch",
    "lastname": "Dillon",
    "phone": "08000000000",
    "otherPhone": "08000000000"
  },
  "summary": {
    "address_check": "IN_PROGRESS"
  },
  "address": {
    "verificationTypeCode": "address",
    "organisationId": 1,
    "requestedAt": "2026-07-30T12:36:54.000Z",
    "requestSource": "api",
    "archived": false,
    "stateId": 1,
    "stateName": "Abia",
    "lgaId": 1,
    "lgaName": "Aba North",
    "applicationId": 362,
    "countryName": "Nigeria",
    "isLive": false,
    "isDuplicate": false,
    "location": {
      "city": "Abia city",
      "initialLatitude": 5.1268221,
      "initialLongitude": 7.367862400000001,
      "landmark": "string",
      "latitude": 5.1268221,
      "lgaName": "Aba North",
      "locationUrl": "https://maps.google.com/?q=5.1268221,7.367862400000001",
      "longitude": 7.367862400000001,
      "stateName": "Abia",
      "street": "string"
    },
    "addressBasic": {
      "addressType": "",
      "allowRevisit": true
    },
    "isVague": true,
    "customerReference": "some-reference",
    "paymentMethodCode": "standard",
    "price": 0,
    "forMarketplace": false,
    "verificationSummary": "",
    "status": {
      "status": "IN_PROGRESS",
      "subStatus": "IN PROGRESS",
      "state": "IN_PROGRESS"
    },
    "reportURL": "https://qoremedia.qoreid.ng/v1/report/address/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ2ZXJpZmljYXRpb25JZCI6NDg3ODksImFjY291bnRJZCI6OCwiYXBwbGljYXRpb25JZCI6MzYyLCJpc0xpdmUiOmZhbHNlLCJwcm9kdWN0Q29kZSI6IiIsInZlcmlmaWNhdGlvblR5cGVDb2RlIjoiYWRkcmVzcyIsInRva2VuIjoiIiwiaWF0IjoxNzg1NDE1MDE3LCJleHAiOjE3ODU1ODc4MTcsImlzcyI6InFvcmUtaWQifQ.4qUDeat-j4TxF5jY0xzg2WNH73t04kjR7fsPdQf3oCw",
    "addressExtraData": {
      "applicantPhoto1": "https://qoremedia.qoreid.ng/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy1wcm8tcGhvdG8tSjdNWk1vTml5UWFVRXFpTEQ2Y2tlIiwiYmt0IjoicW9yZWlkLWRldiIsImlhdCI6MTc4NTQxNTAxNywiZXhwIjoxODE2OTUxMDE3LCJpc3MiOiJxb3JlLWlkIn0.kDv3yuwsZrTMIEAIslofq3QX4y2XucZS-VqSVKke_Ms",
      "applicantPhoto2": "https://qoremedia.qoreid.ng/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy1wcm8tcGhvdG8tWVgwdUFXNi1FWDRnV18tUk9GdjBhIiwiYmt0IjoicW9yZWlkLWRldiIsImlhdCI6MTc4NTQxNTAxNywiZXhwIjoxODE2OTUxMDE3LCJpc3MiOiJxb3JlLWlkIn0._8MxJsFjNBsUpLyG3kHxsmJSfyGGCG2SiE96nx9d-Zk",
      "applicantPhoto3": "https://qoremedia.qoreid.ng/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy1wcm8tcGhvdG8tV2EzRlFCUmp1eTMyT0xGeENaN3hXIiwiYmt0IjoicW9yZWlkLWRldiIsImlhdCI6MTc4NTQxNTAxNywiZXhwIjoxODE2OTUxMDE3LCJpc3MiOiJxb3JlLWlkIn0.X37q4g-HhGfZEkq1IJDV5KYf2vyKrO1Etq6n2aCirFI",
      "buildingColour": "blue",
      "buildingDescription": "Residential",
      "buildingStatus": "Completed",
      "buildingType": "Multi-story",
      "generalDescription": "Green house, third building on the left after the street junction, with a white gate and a large tree in front.",
      "hasGateAndFence": true,
      "houseNumber": "3",
      "latitude": 17.4,
      "longitude": 23.2
    }
  }
}
   "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,
          "sameOrganisationNeighborCount": 5,
          "insightsData": {
            "sameOrganisationNeighborCount": 1,
            "intervalType": "month",
            "intervalValue": 12,
            "industries": [
                {
                    "industryName": "Telecommunications",
                    "applicantCount": 1
                }
            ],
            "startDate": "2025-03-13T12:46:03.000Z",
            "endDate": "2026-03-13T12:46:03.000Z",
            "totalApplicantCount": 1
          },		
          "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
          },
          "addressExtraData": {
             "applicantPhoto1": "https://qoremedia.qoreid.ng/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy1wcm8tcGhvdG8tSjdNWk1vTml5UWFVRXFpTEQ2Y2tlIiwiYmt0IjoicW9yZWlkLWRldiIsImlhdCI6MTc4NTQxNTAxNywiZXhwIjoxODE2OTUxMDE3LCJpc3MiOiJxb3JlLWlkIn0.kDv3yuwsZrTMIEAIslofq3QX4y2XucZS-VqSVKke_Ms",
             "applicantPhoto2": "https://qoremedia.qoreid.ng/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy1wcm8tcGhvdG8tWVgwdUFXNi1FWDRnV18tUk9GdjBhIiwiYmt0IjoicW9yZWlkLWRldiIsImlhdCI6MTc4NTQxNTAxNywiZXhwIjoxODE2OTUxMDE3LCJpc3MiOiJxb3JlLWlkIn0._8MxJsFjNBsUpLyG3kHxsmJSfyGGCG2SiE96nx9d-Zk",
             "applicantPhoto3": "https://qoremedia.qoreid.ng/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy1wcm8tcGhvdG8tV2EzRlFCUmp1eTMyT0xGeENaN3hXIiwiYmt0IjoicW9yZWlkLWRldiIsImlhdCI6MTc4NTQxNTAxNywiZXhwIjoxODE2OTUxMDE3LCJpc3MiOiJxb3JlLWlkIn0.X37q4g-HhGfZEkq1IJDV5KYf2vyKrO1Etq6n2aCirFI",
             "buildingColour": "blue",
     				 "buildingDescription": "Residential",
      			 "buildingStatus": "Completed",
     				 "buildingType": "Multi-story",
     				 "generalDescription": "Green house, third building on the left after the street junction, with a white gate and a large tree in front.",
     				 "hasGateAndFence": true,
      			 "houseNumber": "3",
      			"latitude": 17.4,
      			"longitude": 23.2
          },
          "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"
      }
    }

Updated 1 day ago

Did this page help you?