# Kenya

Kenya eKYB validates the legitimacy of Kenyan businesses by checking their tax ID, business name, and address against Kenyan government sources of truth.

<Callout icon="⚠️" theme="warn">
  Kenya eKYB is currently available only in the Incode demo environment, not in production. Contact Incode support for availability.
</Callout>

UBOs and directors are not currently supported for Kenya.&#x20;

## Source

| Country | Source                             | Description                                                                           |
| ------- | ---------------------------------- | ------------------------------------------------------------------------------------- |
| Kenya   | Kenyan government sources of truth | Verifies submitted business details against records maintained in Kenyan registries.  |

## Direct API approach

For general integration notes and shared response semantics, see the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference).

### Request parameters

| Parameter      | Required  | Description                                            |
| -------------- | --------- | ------------------------------------------------------ |
| `plugins`      | Mandatory | Array. Must be `["ekyb"]`.                             |
| `businessName` | Mandatory | String. Name of the business.                          |
| `country`      | Mandatory | String. Two-letter Alpha-2 country code. Must be `KE`. |
| `taxId`        | Mandatory | String. Kenyan business tax ID.                        |
| `street`       | Optional  | String. Street name of the business.                   |
| `houseNo`      | Optional  | String. Building or house number.                      |
| `addressLine2` | Optional  | String. Second line of the business address.           |
| `city`         | Optional  | String. City in the business address.                  |

### Sample request

```json
{
  "plugins": ["ekyb"],
  "businessName": "SOUTHAMPTON SPORTS CLUB KENYA LIMITED",
  "street": "Kemp House, Stadium Lane",
  "addressLine2": "Off Moi Avenue",
  "city": "Nairobi",
  "country": "KE",
  "taxId": "P051234567T"
}
```

### Sample response

```json
{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified", "reasonCodes": ["REGNO"] },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    { "key": "entityType", "sub_label": "Private Limited Company (Ltd)" }
  ]
}
```

### Response fields

| Key                    | Status                                        | Description                                                                                                     |
| ---------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `name`                 | `Verified`, `Approximate Match`, `Unverified` | Submitted business name against the business name associated with the tax ID.                                   |
| `tin`                  | `Found`, `Not Found`                          | Submitted tax ID against the government database.                                                               |
| `address_verification` | `Verified`, `Approximate Match`, `Unverified` | Submitted address against the address associated with the tax ID.                                               |
| `cityMatch`            | `Verified`, `Approximate Match`, `Unverified` | Submitted city against the city associated with the tax ID.                                                     |
| `registrationStatus`   | `Active`, `Inactive`, `Unknown`               | Registration status of the business. `Inactive` includes suspended businesses and those no longer in operation. |
| `entityType`           | Legal entity type of the business             | The legal entity type of the company, if available. If not available, displays `Unknown`.                       |

### Error responses

See the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference) for standard error responses.

## Single Session Dashboard results

View eKYB results on the Business tab in [single Session view](https://developer.incode.com/docs/single-session-view).