Verify Business Addresses in Nigeria

All file links (e.g. selfie URLs, document URLs) returned in the response expire within one hour. We strongly recommend transferring these documents and images to your own infrastructure as soon as you receive them. If a link expires before you are able to download the file, call the Fetch Address Verification Data endpoint to generate a new link — which will also expire in one hour.

Request

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

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

Fetch Address Verification Data

Resolve Nuban

Documentation Index

​Request

​Header

​Body parameter

​Sample response

​Response Fields

Request

Header

Body parameter

Sample response

Response Fields