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

Parameters

Type

Description

customerReference (REQUIRED)

string

Customer Reference

street
(REQUIRED)

string

Address Street

stateName
(REQUIRED)

string

Address State Name

lgaName
(REQUIRED)

string

Address Local Govt Area

landmark
(OPTIONAL)

string

Address Landmark

city
(REQUIRED)

string

Address City

originalRequesterName
(OPTIONAL)

string

Original requester name
(main requester company name)

applicant.firstname
(REQUIRED)

string

Applicant First Name

applicant.lastname
(REQUIRED)

string

Applicant Last Name

applicant.phone
(REQUIRED)

string

Applicant Phone Number

applicant.dob
(OPTIONAL)

dateString

Applicant Date Of Birth

applicant.idType
(OPTIONAL)

enum : {nin, bvn, frsc, drivers_license }

Applicant Identification Type

Applicant.idNumber
(OPTIONAL)

string

Applicant identification Number

canContactPoc
(REQUIRED)

boolean

Can Reach out to Contact Person?

rcNumber
(REQUIRED)

string

Registered Company Number

businessType
(REQUIRED)

enum : {Formal , Informal }

Business Type

businessName
(REQUIRED)

string

Registered 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"
        }
      }
    }
  }
}