Request
[GET]
{{baseUrl}}/api/v1/ke/kyb/business?registration_type=pvt®istration_number=PVT-XXXXXXXX
Header
| Header | Type | Description |
|---|---|---|
| AppId | string | Create an app to get your app ID on dashboard here |
| Authorization | string | Private/secret key. Use <key> not Bearer <key> |
Query parameter
| Parameter | Type | Description | Required |
|---|---|---|---|
| registration_type * | string | The business registration type. One of pvt, bn, llp, or bo | required |
| registration_number * | string | The business registration number | required |
Sample response
Response
{
"entity": {
"business_name": "SAMPLE VENTURES LIMITED",
"status": "registered",
"registration_date": "01 January 2020",
"postal_address": "00000 - 00100",
"physical_address": "Sample Plaza, Moi Avenue, Fl: 1st, Nairobi",
"phone_number": "+254700000000",
"registration_number": "PVT-XXXXXXXX",
"registration_type": "pvt",
"branch": null,
"email": "info@sampleventures.co.ke",
"kra_pin": null,
"verified": 1,
"partners": [
{
"type": "director",
"shares": [],
"postal_code": "",
"postal_address": "",
"phone_number": "",
"name": "JOHN DOE",
"id_type": "alien",
"id_number": "10******",
"gender": "M",
"email": ""
},
{
"type": "director_shareholder",
"shares": [
{
"name": "ORDINARY",
"number_of_shares": 100000
}
],
"postal_code": "",
"postal_address": "",
"phone_number": "",
"name": "ACME HOLDINGS, INC.",
"id_type": "foreign_company",
"id_number": "10000000",
"gender": "Other",
"email": ""
},
{
"type": "secretary",
"shares": [],
"postal_code": "",
"postal_address": "",
"phone_number": "",
"name": "JANE DOE",
"id_type": "citizen",
"id_number": "29****",
"gender": "F",
"email": ""
}
],
"shares": [
{
"shares": 100000,
"value": "150.00",
"name": "ORDINARY"
}
],
"encumbrances": []
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
| entity | object | Contains the business verification response data |
| entity.business_name | string | Registered name of the business |
| entity.status | string | Registration status of the business (e.g., “registered”) |
| entity.registration_date | string | Date the business was registered |
| entity.postal_address | string | Postal address of the business |
| entity.physical_address | string | Physical/office address of the business |
| entity.phone_number | string | Business phone number |
| entity.registration_number | string | Business registration number |
| entity.registration_type | string | Business registration type (pvt, bn, llp, or bo) |
| entity.branch | string | null | Branch information, if applicable |
| entity.email | string | Business email address |
| entity.kra_pin | string | null | KRA PIN associated with the business, if available |
| entity.verified | integer | Verification indicator (1 = verified) |
| entity.partners | array | List of partners, directors, shareholders, and secretaries |
| entity.partners[].type | string | Role of the partner (e.g., “director”, “director_shareholder”, “secretary”) |
| entity.partners[].shares | array | Shares held by the partner, if any |
| entity.partners[].shares[].name | string | Share class name (e.g., “ORDINARY”) |
| entity.partners[].shares[].number_of_shares | integer | Number of shares held |
| entity.partners[].postal_code | string | Postal code of the partner |
| entity.partners[].postal_address | string | Postal address of the partner |
| entity.partners[].phone_number | string | Phone number of the partner |
| entity.partners[].name | string | Name of the partner |
| entity.partners[].id_type | string | Identification type (e.g., “citizen”, “alien”, “foreign_company”) |
| entity.partners[].id_number | string | Masked identification number of the partner |
| entity.partners[].gender | string | Gender of the partner (“M”, “F”, or “Other”) |
| entity.partners[].email | string | Email address of the partner |
| entity.shares | array | Summary of the company’s share structure |
| entity.shares[].shares | integer | Total number of shares in this class |
| entity.shares[].value | string | Nominal value per share |
| entity.shares[].name | string | Share class name (e.g., “ORDINARY”) |
| entity.encumbrances | array | List of encumbrances registered against the business |