API Documentation
API ReferenceDeveloper ConsoleDeveloper Community

Business Verification

Suggest Edits

This service enables business verification for businesses in Nigeria.

This endpoint validates business details such as :-

  1. Business name
  2. Registration number
  3. Address
  4. AML match

Process flow

Step one :- Make a post request to the Verification endpoint.

🚧

Please note

The type parameter should be set to CORPORATE. The verificationRequests field is an array that carries the various identification types and their related values.

Sample Request

curl  \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
    "type": "CORPORATE",
    "email": "[email protected]",
    "registeredName": "Excellent Partners Nigeria Limited",
    "verificationRequests": [
            {
                "type": "ADDRESS",
                "buildingNumber": "15B",
                "street": "Oko Awo Street",
                "landmark": "Eko Hotel",
                "city": "Victoria Island"
                "state": "NG-LA",
                "country": "NGA",
                "base64EncodedImage": "/9j/4AAQSkZJRgABAQEASABIAAD//gBcYm9yZGVyIGJzOjAgYmM6IzAwMDAwMCBwczowIHBjOiNlZWVlZWUgZXM6MCBlYzojMDAwMDAwIGNrOjUwMGQwMmE0ZjFmMWQ3NDk3MzQwY2M1ODY4OTZiZjEx/9sAQwAGBAUGBQQGBgUGBwcGCAoQCgoJCQoUDg8MEBcUGBgXFBYWGh0lHxobIxwWFiAsICMmJykqKRkfLTAtKDAlKCko/9sAQwEHBwcKCAoTCgoTKBoWGigoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgo/8AAEQgAGQAZAwEiAAIRAQMRAf/EABgAAQADAQAAAAAAAAAAAAAAAAcEBQYI/8QAMRAAAgECBAQEAgsAAAAAAAAAAQIDBBEABQYSByExQRMUIlEVczI2YWJxcpGTsbLC/8QAFgEBAQEAAAAAAAAAAAAAAAAAAgME/8QAHREAAQUAAwEAAAAAAAAAAAAAAQACAwQREyEiMf/aAAwDAQACEQMRAD8AvuJPGqo0trd9MZZp1qidCiNV1cjRoWcCxVQvNBceq/Pn+OMtFrYfHJqTV1I1JVs1jVbyyqe28AEhelmUkWt6SOYbOONXDRcP2jrL+VqauGKRhzKAN4gKjudyKLfbgyjoNMapmarcJVNTRKiwvuVlFjtuORHL39sRfYMLlpjottRnT2q3I9Z1eU8QsgytJoJaWsZaasjp5N8bNKwWN1IuLg7TuHVW/R48I4EuHOkcqqtWxZzFEhnaqM9LAG2JTww7VLBB1Jaxv95e/PDnY4Yl5fQUpKxrYwnVA4uZM2p9CZhk9FLTLmMjQy04mJsHSRXHQEi4Ui9u+OZpct1lUZjPl9ZFDSeUJpGnEgbaqsVIS3Nu9rjucdXZZ9E/NP8AbB1qf635l8wfwcRsnG6tVEFzi3elUcJcuqMq1E0NPRGeGSjMTylvVCqnde563Jtblzt7YT/Ow+037bYi8Nutf+VP9Y0uFVGxglG9nMQBnxf/2Q=="
            },
            {
                "type": "AML",
                "country": "NGA"
            },
            {
            		"type": "CORPORATE_REGISTRATION",
                "country": "NGA",
                "identityNumber": "1111111111"
                
            }
        ],
    "callbackUrl": "http://localhost:8080"
}' 
-X Post

Sample Response

{
    "verificationResponses": [
        {
            "type": "ADDRESS",
            "status": "PENDING",
            "lastName": "Doe",
            "firstName": "John",
            "birthDate": "1990-01-01",
            "phone": "+2348030000000",
            "buildingNumber": "15B",
            "street": "Oko Awo Street",
            "landmark": "Eko Hotel",
            "city": "Victoria Island",
            "state": "Lagos",
            "country": "Nigeria",
            "reference": "ISW|KYC|ADD|20200122|P64JHM1H7"
        },
        {
            "type": "AML",
            "status": "NO MATCH",
            "kycDomain": "ISW",
            "amlMatches": [],
            "reference": "ISW|KYC|AML|20200122|09390527R"
        },
        {
            "type": "CORPORATE_REGISTRATION",
            "status": "NOT VERIFIED",
            "identityNumber": "33333333333",
          	"registeredName": "Excellent Partners Nigeria Limited"
        }
    ]
}

📘

Reference

Individual and Corporate Verification

Updated over 3 years ago