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