GET
Verify a Kenyan business by its registration number and retrieve its company name, status, registration details, directors and shareholders.
/api/v1/ke/kyb/businessHeaders
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Your app’s secret key, sent as-is — not Bearer. |
AppId | Yes | The App ID from your dashboard. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
registration_type | string | Yes | Business registration type — one of pvt, bn, llp, or bo. |
registration_number | string | Yes | The business registration number. |
Response
Returns anentity with the business’s name, status, registration details, and its partners and shares.
Errors
| Code | Meaning |
|---|---|
400 | Bad request — a required parameter is missing or malformed. |
401 | Unauthorized — check your key and AppId (no Bearer prefix). |
402 | Insufficient wallet balance. Fund your wallet. |
404 | No record found for the supplied identifier. |
429 | Too many requests — back off and retry. |
curl --request GET \
"https://api.dojah.io/api/v1/ke/kyb/business?registration_type=pvt®istration_number=PVT-XXXXXXXX" \
-H "Authorization: {{secret_key}}" \
-H "AppId: {{app_id}}"
const params = new URLSearchParams({
"registration_type": "pvt",
"registration_number": "PVT-XXXXXXXX",
});
const url = "https://api.dojah.io/api/v1/ke/kyb/business?" + params;
const res = await fetch(url, {
headers: {
Authorization: process.env.DOJAH_SECRET_KEY,
AppId: process.env.DOJAH_APP_ID,
},
});
const data = await res.json();
import os, requests
res = requests.get(
"https://api.dojah.io/api/v1/ke/kyb/business",
headers={
"Authorization": os.environ["DOJAH_SECRET_KEY"],
"AppId": os.environ["DOJAH_APP_ID"],
},
params={
"registration_type": "pvt",
"registration_number": "PVT-XXXXXXXX",
},
)
data = res.json()
{
"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": []
}
}