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:
- 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.
- 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
| Key | Description |
|---|---|
| x-api-key | Your Secret Key |
| app-id | Your app id |
Request Body (Search)
| Key | Description |
|---|---|
| company_name | Name of the company |
| check_type | CR12 or CR13 or LLP |
Request Body (Search Advance)
| Key | Description |
|---|---|
| company_id | ID reference of the company |
| check_type | CR12 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)
| Response | Description |
|---|---|
| status | Indicates that the request was successful. |
| response_code | Represents the response code. |
| data | List of company data. |
| name | Name of the company. |
| company_id | Company ID. |
| verified | Boolean indicating whether the company is verified. |
| verification | Verification information. |
| reference | Reference for verification. |
| session | Session-related information. |
Response Description (Search Advance)
| Response | Description |
|---|---|
| status | Indicates that the request was successful. |
| response_code | Represents the response code. |
| data | List of company data. |
| name | Name of the company. |
| company_number | Company number. |
| nominal_share_capital | Nominal share capital. |
| numberand_type_of_shares(value_per_share) | Details of shares and their values. |
| date_of_registration | Date of registration. |
| registered_office | Registered office details, including address, telephone, email, and locality. |
| postal_address | Postal address |
| encumbrances | Information about encumbrances |
| directors | List of directors associated with the company. |
| name | Director's name. |
| description | Director's description |
| address | Director's address |
| nationality | Director's nationality |
| shares | Director's shares details |
| file_base64 | Base64-encoded file content. |
| Session-related information. | Session-related information |
Updated about 1 year ago