Verify Business Addresses in Nigeria

Verify a business address with one API call. Send company and address details and get physical verification and a reference ID.

Request

{{baseUrl}}/api/v1/kyc/address/business

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Body parameter

Parameter	Type	Description	Required
business_name	string	Name of business	required
business_mobile	string	Office mobile number of the business	required
first_name	string	First name of business owner	required
last_name	string	Last name of business owner	required
mobile	string	Mobile number of business owner	required
street	string	House number, street name of the business	required
landmark	string	The closest landmark to the location	optional
lga	string	LGA	required
city	string	City	required
state	string	State	required

Sample response

Response

{
    "entity": {
        "status":"pending" ,
        "reference_id": "69e10264-4b90-64fe-b4b7-c9dddafd0241"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the response data
entity.status	string	Verification request status. Values: pending (verification in progress), completed (verification finished), failed (verification could not be completed)
entity.reference_id	string	Unique reference ID for tracking this verification request. Use this ID to fetch verification results later