Skip to main content

​
Verify businesses using their Business Registration Number

Adhere’s Business Registration endpoint allows you to retrieve verified company information, including directors, beneficial owners, and shareholding structure, using a valid Kenya business registration number.

​
Request Endpoint

POST {{BASE_URL}}/api/onboarding/kenya_kyc/business_registration/
  • Media-Type: application/json

​
Status Codes

  • 200 OK: The request was successful, and the business details are returned successfully.
  • 400 Bad Request: The request could not be completed due to invalid or missing information.

​
Sample Payload

{
    "registration_number": "PVT-ABC123",
    "postal_code": "00100",
    "postal_address": "1234"
}
200 OK Response 
{
    "status": "success",
    "data": {
        "valid": true,
        "success": true,
        "directors": [
            {
                "name": "JAMES KARIUKI MWANGI",
                "gender": "Male",
                "address": "P.O BOX 1234 NAIROBI",
                "id_type": "National ID",
                "id_number": "A12345678",
                "occupation": "Director",
                "nationality": "Citizen",
                "phone_number": "N/A",
                "date_of_birth": "N/A",
                "shareholdings": 10,
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 10
                    }
                ]
            },
            {
                "name": "GRACE WANJIKU ODHIAMBO",
                "gender": "Female",
                "address": "P.O BOX 5678 NAIROBI",
                "id_type": "National ID",
                "id_number": "B87654321",
                "occupation": "Director",
                "nationality": "Citizen",
                "phone_number": "N/A",
                "date_of_birth": "N/A",
                "shareholdings": 0,
                "shareholding_breakdown": []
            }
        ],
        "documents": {},
        "fiduciaries": [],
        "proprietors": [],
        "beneficial_owners": [
            {
                "name": "JAMES KARIUKI MWANGI",
                "gender": "Male",
                "address": "P.O BOX 1234 NAIROBI",
                "nationality": "Citizen",
                "phone_number": "N/A",
                "shareholdings": 10,
                "shareholder_type": "Individual",
                "registration_number": "N/A",
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 10
                    }
                ]
            },
            {
                "name": "KENYA TECH SOLUTIONS LIMITED",
                "gender": "N/A",
                "address": "N/A",
                "nationality": "N/A",
                "phone_number": "N/A",
                "shareholdings": 50,
                "shareholder_type": "Foreign_company",
                "registration_number": "1234567",
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 50
                    }
                ]
            },
            {
                "name": "EASTAFRICA KONSULT INTEGRATED SERVICES LIMITED",
                "gender": "N/A",
                "address": "N/A",
                "nationality": "N/A",
                "phone_number": "N/A",
                "shareholdings": 40,
                "shareholder_type": "Foreign_company",
                "registration_number": "7654321",
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 40
                    }
                ]
            }
        ]
    },
    "message": "Business Registration details retrieved successfully"
}
400 Bad Request Response 
{
    "status": "failed",
    "data": [],
    "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}