Business Registration Service (BRS)

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.

To fully utilize this endpoint, it is implemented in two distinct phases:

  1. Search: During this phase, merchants initiate a search by providing the company name as input. In response, our system generates a list of various companies, each accompanied by a unique company ID.
  2. Search Advance: In this phase, merchants can take advantage of the company ID acquired during the initial search. By passing this company 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

company_name: peleza

company_id: PVT/2016/028721

πŸ“˜

POST

Search:{{URL}}/identitypass/verification/ke/brs/search

Search Advance: {{URL}}identitypass/verification/ke/brs/search/advanced

Request Header

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

Request Body (Search)

KeyDescription
company_nameName of the company
check_typeCR12 or CR13 or LLP

Request Body (Search Advance)

KeyDescription
company_idID reference of the company
check_typeCR12 or CR13 or LLP

Response (Search)

{
    "status": true,
    "response_code": "00",
    "data": [
        {
            "name": "John Doe Ventures",
            "company_id": "ABC/2014/000111",
            "verified": false
        },
        {
            "name": "Dolly Ventures",
            "company_id": "DEF/2016/028721",
            "verified": true
        }
    ],
    "verification": {
        "reference": "9087uytr-c1c2-4e66-82b1-2fbe0898cee7"
    },
    "session": {}
}

Response (Search Advance)

{
    "status": true,
    "response_code": "00",
    "data": {
        "company": "John Doe Ventured",
        "company_number": "ABC/2010/000111",
        "nominal_share_capital": "160,000.00",
        "number_and_type_of_shares_(value_per_share)": "ORDINARY: 1600 (KES 100.00 EACH)",
        "date_of_registration": "18TH OCT, 2016",
        "registered_office": "P.O BOX 20816 KENYATTA N.HOSPITAL TELEPHONE: +25491234567, EMAIL: [email protected] COUNTY: NAIROBI, DISTRICT: WESTLANDS DISTRICT , LOCALITY: WESTLANDS STREET: ST DALLA ROAD, BUILDING: 50",
        "postal_address": "P.O BOX 9087 KENYATTA N.HOSPITAL",
        "encumbrances": "",
        "directors": [
            {
                "name": "JOHN DOE",
                "description": "DIRECTOR",
                "address": "P.O BOX 11034 KENYATTA N.HOSPITAL",
                "nationality": "KENYAN",
                "shares": "ORDINARY: 1600"
            }
        ],
        "file_base64": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/KQovQ3JlYXRvciAo/v8AdwBrAGgAdABtAGwAdABvAHAAZABmACAAMAAuADEAMgAuADQpCi9Qcm9kdWNlciAo/v8AUQB0ACAANAAuADgALgA3KQovQ3JlYXRpb25EYXRlIChEOjIwMjMwOTIyMTYxOTI1WikKPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL0V4dEdTdGF0ZQovU0EgdHJ1ZQovU00gMC4wMgovY2EgMS4wCi9DQSAxLjAKL0FJUyBmYWxzZQovU01hc2sgL05vbmU+PgplbmRvYmoKNCAwIG9iagpbL1BhdHRlcm4gL0RldmljZVJHQl0KZW5kb2JqCjcgMCBvYmoKPDwKL1R5cGUgL1hPYmplY3QKL1N1YnR5cGUgL0ltYWdlCi9XaWR0aCAyNzAKL0hlaWdodCAyMTYKL0JpdHNQZXJDb21wb25lbnQgOAovQ29sb3JTcGFjZSAvRGV2aWNlR3JheQovTGVuZ3RoIDggMCBSCi9GaWx0ZXIgL0ZsYXRlRGVjb2RlCj4+CnN0cmVhbQp4nO1debyV0/pfHXUrp7QrRYNs+rlK0UEhok26pnDkJnFpk1muI1Io7S4NuDgJkftjR+jKcArRQDtCqBzRIA27SXWis6tT59QZ1n3X+K53WO+w97t2x+fT95+93zU861nf933Xu4ZnPQuAwNC/eXCyvKLvMdkv0xs+mJ31IvvvOgh3wBs6w3uyXGITOCXLJfpAMTw1uwX+DI/OboF+kA//aJLN8l6Fn2WzOJ+oswN+l8XiBkN4SRaL842xEE7KWmE9IdyctcLSQWsI4W1ZKqvlXgiHZamsNFGk0XFmdor6CcLKUHaKShdnamzsOjIbJU3TSno1GwVlgh81JX/IQjkPaOXAjlkoKCNci7R8XXkxvVExXygvJmOUID3vV1xIu/2olIsUlxIARiI94QVKy8hZjcpYo7SMYNCsCmlaoXRoWYQZz9anPCPEsaorFJYwCpew5y8KiwgMHbCucLqyAq4kBTylrIBAMZ9oO0KR+PZEfG0evYo4n6qrZkRVfxOR/l8l0hVgFdG35ngVwudQrjurEK4CA6nC6+sGL/sJKvur4EUrQs4OqvKHgYseQCXDiwMXrQwjmM5jAxbckQleG7BglWhaxbT+e6ByD/+Nyb09ULmKMZlpHewwcwGTuktBi6QOx3E2tjUITurzXGosOKHZwIdc8eBmtW/lMqubBiY0K+jKNYeFAYnspot8JSCRStDNJuw7XfcbXQUcNuVF1zShUl1ie2t0g64eFFWPWycshD9bv/59dN2hHVsijv0BwjkuD/9fftDlfWyNHrAeznvmOu9aq0HHd4iCY84xx6zXtS92ltET3/Wk89fnPoFdy6T8Bc+SiNfC/rQPGD12MQ3fN0fdqWtfnuMkox9NVRZxSjVdF7fEEvkFi9rawW8NgsI7a2aPXQVZP2umObouJwr+7CTmLr2aVzskG6Uny7dEMjZq4OJxn6/N3mqfjs7QgPGWBGN53EsOYoaJQm6RpzuPJ9pkjZxiUKWinf/aZIolRjaKjjMnaMHjHFq3h4xS7pAmbLibpbHaiHRaYJRieU5Vo/Wj0ISaj81jkqfZvZJ/Lh4xS7lTmvS/NMX2w0wRN8w3C6kcfFT6NfONZhOWHDBrgPCQMVkOnZip+D+ZIAulEA6Spf2MxG8+2xT+vFUGhPsWjWuYURV94DY7BTTsb2VKeOqdr/+khS8AjZvZybnXTkhfu5TNcm"
    },
    "session": {}
}

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