> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lookup Kenya Business

> Verify a Kenyan business (KYB) and fetch company details, partners, and shareholding from the Business Registration Service.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/ke/kyb/business?registration_type=pvt&registration_number=PVT-XXXXXXXX
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| 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

```json Response theme={null}
{
    "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                         |