Business Address

Verify the physical address of any business in Nigeria using our last mile verification agents.

To conduct a live test

{{baseUrl}}/v1/addresses/business

Request Body

ParametersTypeDescription
customerReference
(REQUIRED)
stringCustomer Reference
street
(REQUIRED)
stringAddress Street
stateName
(REQUIRED)
stringAddress State Name
lgaName
(REQUIRED)
stringAddress Local Govt Area
landmark
(OPTIONAL)
stringAddress Landmark
city
(REQUIRED)
stringAddress City
applicant.firstname
(REQUIRED)
stringApplicant First Name
applicant.lastname
(REQUIRED)
stringApplicant Last Name
applicant.phone
(REQUIRED)
stringApplicant Phone Number
applicant.dob
(OPTIONAL)
dateStringApplicant Date Of Birth
applicant.idType
(OPTIONAL)
enum : {nin, bvn, frsc, drivers_license }Applicant Identification Type
Applicant.idNumber
(OPTIONAL)
stringApplicant identification Number
canContactPoc
(REQUIRED)
booleanCan Reach out to Contact Person?
rcNumber
(REQUIRED)
stringRegistered Company Number
businessType
(REQUIRED)
enum : {Formal , Informal }Business Type
businessName
(REQUIRED)
stringRegistered Business Name

Response Sample

{
    "id": 53,
    "customerReference": "Buinesss",
    "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:57:56.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"
        },
        "business": {
            "businessName": "Osakpolor business enterprise ojowowa",
            "businessType": "Formal",
            "canContactPoc": true,
            "rcNumber": "12345678"
        },
        "isVague": false,
        "customerReference": "Buinesss",
        "paymentMethodCode": "standard",
        "price": 0,
        "updatedAt": "2022-11-02T21:57:56.000Z",
        "status": {
            "status": "IN_PROGRESS",
            "subStatus": "IN PROGRESS",
            "state": "IN_PROGRESS"
        }
    },
    "duplicateRequest": false
}
{
  
  "bodyRaw": "{\"event\":\"address\",\"event_type\":\"verification_completed\",\"data\":{\"id\":3846135,\"summary\":null,\"customerReference\":\"1qtesi-5\",\"address\":{\"id\":3846135,\"verificationTypeCode\":\"address\",\"organisationId\":86923,\"userId\":null,\"approvedAt\":\"2023-04-26T10:55:44.000Z\",\"requestedAt\":\"2023-04-26T10:44:53.000Z\",\"identityVerificationId\":null,\"requestSource\":\"api\",\"archived\":false,\"apiReference\":null,\"stateId\":15,\"stateName\":\"FCT\",\"lgaId\":273,\"lgaName\":\"Abuja Municipal\",\"applicationId\":131,\"neighbor\":{\"comment\":null,\"firstname\":null,\"lastname\":null,\"phone\":null},\"countryName\":\"Nigeria\",\"isLive\":true,\"location\":{\"city\":\"mushin\",\"initialLatitude\":9.059171,\"initialLongitude\":7.5151534,\"landmark\":\"mushin\",\"latitude\":6.299762,\"lgaName\":\"Abuja Municipal\",\"locationUrl\":\"https://maps.google.com/?q=9.059171,7.5151534\",\"longitude\":5.6022687,\"stateName\":\"FCT\",\"street\":\"13,adetobi kofoworola street ajayi\"},\"addressBasic\":{\"addressType\":\"\"},\"business\":{\"area\":\"commercial\",\"businessName\":\"Osakpolor business enterprise ojowowa\",\"businessType\":\"Formal\",\"canContactPoc\":true,\"id\":null,\"isKnown\":true,\"isOwnerKnown\":true,\"name\":null,\"nameFound\":\"\",\"ownerVisitsFrequently\":true,\"rcNumber\":\"12345678\",\"type\":null},\"isVague\":false,\"customerReference\":\"1qtesi-5\",\"paymentMethodCode\":\"standard\",\"applicant\":{\"firstname\":\"Kolade\",\"middlename\":\"toyosi\",\"lastname\":\"Alade\",\"gender\":\"female\",\"maritalStatus\":null,\"phone\":\"+2349012345678\",\"email\":\"[email protected]\",\"dob\":\"2022-09-14\",\"photo\":null},\"price\":800,\"agentComment\":\"Verification completed\",\"adminComment\":null,\"agentSubmittedAt\":\"2023-04-26T10:54:50.000Z\",\"verifindData\":{\"buildingImageDistance\":null,\"deviceLocationDistance\":null,\"isTrackingSessionActive\":null,\"isVerifind4d\":false,\"selfieImageDistance\":null,\"surroundingImageDistance\":null,\"trackingEndedAt\":null,\"trackingStartedAt\":null},\"rejectedAt\":null,\"interiorPhotos\":{\"photo1\":\"https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvNC11bmRlZmluZWQtNzk0ODc4OTIiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.GQ1_9KMJfSl-c1ihYMxSBAhXh91VHahYynH7sXado8w\",\"photo2\":\"https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvNS11bmRlZmluZWQtMzYwNDQ3OTEiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.RfIkW0WPYt_pOA_5TXeRM2CiAePE7-_BFH-zAcKALuE\",\"photo3\":\"https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvNi11bmRlZmluZWQtNzkxODI3NDYiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.NHHw04DpUQDCP7iZ4m2CsRk6FZMfUUCT8iO9FbCUj1w\"},\"exteriorPhotos\":{\"photo1\":\"https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvMS11bmRlZmluZWQtNjc4MzYyOTgiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.61XJVljVZ0rYGUpY_G6gooMJNZGkDiMWOjCFdR6Pr3c\",\"photo2\":\"https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvMi11bmRlZmluZWQtOTM2MTQ4NzEiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NSwiZXhwIjoxNzE0MTI4OTQ1LCJpc3MiOiJxb3JlLWlkIn0.lrvrbh2GDx3xOWunOu5Vk_whUTnUEdLTNC59k7tIjx8\",\"photo3\":\"https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvMy11bmRlZmluZWQtMjE2NDk3MDAiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NSwiZXhwIjoxNzE0MTI4OTQ1LCJpc3MiOiJxb3JlLWlkIn0.Pnvwai9qM2SaHz3-lLy6BKT3buS2W5SEGBmbTMUh4ME\"},\"extraPhotos\":{},\"status\":{\"status\":\"VERIFIED\",\"subStatus\":\"VERIFIED\",\"state\":\"COMPLETE\"}}}}",
  "body": {
    "event": "address",
    "event_type": "verification_completed",
    "data": {
      "id": 3846135,
      "summary": null,
      "customerReference": "1qtesi-5",
      "address": {
        "id": 3846135,
        "verificationTypeCode": "address",
        "organisationId": 86923,
        "userId": null,
        "approvedAt": "2023-04-26T10:55:44.000Z",
        "requestedAt": "2023-04-26T10:44:53.000Z",
        "identityVerificationId": null,
        "requestSource": "api",
        "archived": false,
        "apiReference": null,
        "stateId": 15,
        "stateName": "FCT",
        "lgaId": 273,
        "lgaName": "Abuja Municipal",
        "applicationId": 131,
        "neighbor": {
          "comment": null,
          "firstname": null,
          "lastname": null,
          "phone": null
        },
        "countryName": "Nigeria",
        "isLive": true,
        "location": {
          "city": "mushin",
          "initialLatitude": 9.059171,
          "initialLongitude": 7.5151534,
          "landmark": "mushin",
          "latitude": 6.299762,
          "lgaName": "Abuja Municipal",
          "locationUrl": "https://maps.google.com/?q=9.059171,7.5151534",
          "longitude": 5.6022687,
          "stateName": "FCT",
          "street": "13,adetobi kofoworola street ajayi"
        },
        "addressBasic": {
          "addressType": ""
        },
        "business": {
          "area": "commercial",
          "businessName": "Osakpolor business enterprise ojowowa",
          "businessType": "Formal",
          "canContactPoc": true,
          "id": null,
          "isKnown": true,
          "isOwnerKnown": true,
          "name": null,
          "nameFound": "",
          "ownerVisitsFrequently": true,
          "rcNumber": "12345678",
          "type": null
        },
        "isVague": false,
        "customerReference": "1qtesi-5",
        "paymentMethodCode": "standard",
        "applicant": {
          "firstname": "Kolade",
          "middlename": "toyosi",
          "lastname": "Alade",
          "gender": "female",
          "maritalStatus": null,
          "phone": "+2349012345008",
          "email": "[email protected]",
          "dob": "2022-09-14",
          "photo": null
        },
        "price": 800,
        "agentComment": "Verification completed",
        "adminComment": null,
        "agentSubmittedAt": "2023-04-26T10:54:50.000Z",
        "verifindData": {
          "buildingImageDistance": null,
          "deviceLocationDistance": null,
          "isTrackingSessionActive": null,
          "isVerifind4d": false,
          "selfieImageDistance": null,
          "surroundingImageDistance": null,
          "trackingEndedAt": null,
          "trackingStartedAt": null
        },
        "rejectedAt": null,
        "interiorPhotos": {
          "photo1": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvNC11bmRlZmluZWQtNzk0ODc4OTIiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.GQ1_9KMJfSl-c1ihYMxSBAhXh91VHahYynH7sXado8w",
          "photo2": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvNS11bmRlZmluZWQtMzYwNDQ3OTEiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.RfIkW0WPYt_pOA_5TXeRM2CiAePE7-_BFH-zAcKALuE",
          "photo3": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvNi11bmRlZmluZWQtNzkxODI3NDYiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.NHHw04DpUQDCP7iZ4m2CsRk6FZMfUUCT8iO9FbCUj1w"
        },
        "exteriorPhotos": {
          "photo1": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvMS11bmRlZmluZWQtNjc4MzYyOTgiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NCwiZXhwIjoxNzE0MTI4OTQ0LCJpc3MiOiJxb3JlLWlkIn0.61XJVljVZ0rYGUpY_G6gooMJNZGkDiMWOjCFdR6Pr3c",
          "photo2": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvMi11bmRlZmluZWQtOTM2MTQ4NzEiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NSwiZXhwIjoxNzE0MTI4OTQ1LCJpc3MiOiJxb3JlLWlkIn0.lrvrbh2GDx3xOWunOu5Vk_whUTnUEdLTNC59k7tIjx8",
          "photo3": "https://media.qoreid.com/v1/file/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ2ZXJpZmljYXRpb24tc2VydmljZS1pbWFnZXMvYWRkcmVzcy0zODQ2MTM1LXBob3RvMy11bmRlZmluZWQtMjE2NDk3MDAiLCJia3QiOiJxb3JlaWQtbGl2ZSIsImlhdCI6MTY4MjUwNjU0NSwiZXhwIjoxNzE0MTI4OTQ1LCJpc3MiOiJxb3JlLWlkIn0.Pnvwai9qM2SaHz3-lLy6BKT3buS2W5SEGBmbTMUh4ME"
        },
        "extraPhotos": {},
        "status": {
          "status": "VERIFIED",
          "subStatus": "VERIFIED",
          "state": "COMPLETE"
        }
      }
    }
  }
}