Business Ownership Advance

Validate Business Registration Number

This particular endpoint serves the critical function of verifying a business's registration number by cross-referencing it with the Kenyan Business Registration Service (BRS). This validation is crucial to ensure that the registration information is accurate and legitimate. It plays a key role in maintaining the reliability and trustworthiness of our platform by preventing the inclusion of incorrect or fraudulent business data. Our seamless integration with the BRS helps us verify and validate businesses more effectively, enhancing trust and compliance within our system.

By passing this Business ID as a reference point, merchants can access comprehensive and detailed information about a specific business. This advanced search feature enables merchants to retrieve in-depth insights into the selected company, facilitating informed decisions and actions.

👍

TEST DATA

check_type: CR12 or CR13 or LLP

company_id: PVT/2016/028721

📘

POST: https://api.prembly.com/identitypass/verification/ke/brs/search/advanced

Request Header

KeyDescription
x-api-keyYour Secret Key
app-idYour app id

Request Body

KeyDescription
check_typeCR12 or CR13 or LLP
company_idbusiness registration number
keyDescription
CR12Company search
CR13Business search
LLPLimited liability partnership

Response

{
    "status": true,
    "detail": "Verification Successful",
    "response_code": "00",
    "data": {
        "verified": true,
        "status": "registered",
        "registrationNumber": "BN-2QQQQQZV",
        "registrationDate": "22 September 2001",
        "postalAddress": "3231 - 10200",
        "physicalAddress": "ANDI BUILDING, PITAL ROUNDABOUT, Fl: GROUND FLOOR, Room/Door: ROOM 1, ANDI BUILDING, PITAL ROUNDABOUT",
        "phoneNumber": "+254111111112",
        "email": "[email protected]",
        "businessName": "ISH WORKS",
        "branch": null,
        "partners": [
            {
                "type": "proprietor",
                "name": "TOR KKARJA",
                "idType": "citizen",
                "idNumber": "2222225",
                "shares": [],
                "country": "Kenya"
            }
        ],
        "shareCapital": [],
        "encumbrances": []
    },
    "verification": {
        "status": "VERIFIED",
        "reference": "5fbkfbc-3b3d-477c-bbca-ff4edg76098"
    },
    "widget_info": {},
    "session": {},
    "endpoint_name": "Business Ownership Advance (Kenya)"
}

Response Description (search)

ResponseDescription
statusIndicates that the request was successful.
response_codeRepresents the response code.
dataList of company data.
nameName of the company.
company_idCompany ID.
verifiedBoolean indicating whether the company is verified.
verificationVerification information.
referenceReference for verification.
sessionSession-related information.

Response Description (Search Advance)

ResponseDescription
statusIndicates that the request was successful.
response_codeRepresents the response code.
dataList of company data.
nameName of the company.
company_numberCompany number.
nominal_share_capitalNominal share capital.
numberand_type_of_shares(value_per_share)Details of shares and their values.
date_of_registrationDate of registration.
registered_officeRegistered office details, including address, telephone, email, and locality.
postal_addressPostal address
encumbrancesInformation about encumbrances
directorsList of directors associated with the company.
nameDirector's name.
descriptionDirector's description
addressDirector's address
nationalityDirector's nationality
sharesDirector's shares details
file_base64Base64-encoded file content.
Session-related information.Session-related information