Submit Business Verification

​
Please note that you are required to have a webhook set for business verification requests to be successful. If they are not set, you will not get notified when the verification has been completed.
​
post
Submit Business Address for Verification
https://vapi.verifyme.ng/v1/verifications/businesses
This endpoint allows you to create business verification requests
Request
Response
Request
Headers
Authentication 
required
string
Authentication Token
Body Parameters
reference
optional
string
unique identifier for requests
canContactPoc
optional
boolean
Can We Reach Out To Contact Person 
applicant.firstname
required
string
Contact Person First name
applicant.lastname
required
string
Contact Person Last name
applicant.email
optional
string
Contact Person Email or Business Official Email
applicants.phone
required
string
Contact Person Phone No or Business contact line
applicant.idType
required
string
 Contact Person Id Type ("BVN", "NIN", "KYC PHONE", "DRIVERS LICENCE")
applicant.idNumber
required
string
Contact Person Identity Number ("NIN", "BVN", "PHONE NO")
city
optional
string
city name
state
required
string
state name
lga
required
string
Local Government Area  
street
required
string
Street Name e.g 270, Muritala Mohammed Way, Alagomeji Yaba.
rcNumber
optional
string
Registration Number
type
required
string
Business Type(Formal , Informal)
name
required
string
registered business name
Response
200: OK
{
"status": "success",
"data": {
    id: 1,
    applicant: {
        firstname: "John",
        lastname: "Doe",
        phone:"08000000000",
        idType: "bvn",
        idNumber: "10000000001",
        middlename: "Cameron',
        photo: "https://images.verifyme.ng/278783775/fjjjjler7834.jpg",
        gender: "Male",
        birthdate: '17/01/1988',
    },
    business: {
        name: "Ade & Sons Global World",
        type: "Formal",
        rcNumber:"123453",
        isBusinessKnown : true,
        isBusinessOwnerKnown : true
        ownerVisitsFrequently : false
    },
    canContactPoc: "false",
    createdAt: "",
    completedAt: "",
    lattitude: "9.081999",
    longitude: "8.675277",
    photos: ["https://picsum.photos/id/768/200/300.jpg", "https://picsum.photos/id/768/200/300.jpg"],
    status: {
        status: "In Progress",
        subStatus: "In Progress",
        state: "In Progress",
    },
    city: "oshodi",
    street: "270 Murtala Muhammed Way, Alagomeji. Yaba",
    lga: "lagos mainland",
    state: "Lagos",
    country: "Nigeria",
    reference: "VMN_dsmdms"
}
401: Unauthorized
Unauthorised 
{
    "status": "error",
    "message": "string",
    "code": "ACCESS_DENIED"
}
​
Sample Request
JSON
CURL
JSON
{
    "name": "Ade & Sons Global World",
    "type": "Formal",
    "rcNumber":"ad123453",
    "street": "270 Murtala Muhammed Way, Alagomeji. Yaba",
    "lga": "surulere",
    "state": "lagos",
    "canContactPoc": "false",
    "applicant": {
        "idType": "NIN",
        "idNumber": "10000000001",
        "firstname": "john",
        "lastname": "doe",
        "phone": "08121234567",
        "email":"[email protected]"
    }
}
CURL
curl --verbose  
--header "Authorization: Bearer <token>"
--data '{ "name": "Ade & Sons Global World","type": "Formal","rcNumber":"ad123453","street": "270 Murtala Muhammed Way, Alagomeji. Yaba", "lga": "sululere", "city": "lagos","canContactPoc": "false","applicant": {    "idType": "NIN",    "idNumber": "10000000001",    "firstname": "john",    "lastname": "doe",    "phone": "08121234567",    "dob":"04-04-1944"}}' 
--request "POST" "https://vapi.verifyme.ng/v1/verifications/addresses"
Fetch an Address By Identity
Next - Business Verification
Get Business Verification By ID
Last updated 1 month ago
Submit Business Verification

postSubmit Business Address for Verification

Sample Request

post
Submit Business Address for Verification
