Business
Search Kenyan business registrations via POST /api/v1/business/ke. All of registration_number, search_type, and consent (must be true) are required. Use search_type: pvt (company — shares & encumbrances), bn (sole proprietor — partners only), llp (limited liability partnership), or bo (beneficial owner — partners only). Registration format is validated per type. Fresh registry snapshots are reused for up to 7 days. Success and not-found (404) are billable; validation (422) and unsupported countries are not. Other country codes are not supported yet.
Sandbox test data
Use these values against the sandbox host. Click a value to copy it.
Verify business registration
{{baseUrl}}/api/v1/business/keHeader
Body Parameters
Company search (pvt / llp)
Sample request body for Company search (pvt / llp):
{
"registration_number": "CPV/2019/184726H",
"search_type": "pvt",
"consent": true
}Sample response for Company search (pvt / llp):
{
"success": true,
"response_code": 200,
"message": "Company Search verification successful",
"country": "ke",
"data": {
"registration_number": "CPV/2019/184726H",
"business_name": "Horizon Capital Holdings Limited",
"status": "Registered",
"registration_date": "2019-03-18",
"postal_address": "P.O. Box 47261-00100, Nairobi",
"physical_address": "14 Riverside Drive, Nairobi",
"phone_number": "0712845631",
"branch": null,
"email": "info@horizoncapital.co.ke",
"kra_pin": "P051847261X",
"verified": true,
"partners": [
{
"type": "Director",
"shares": [],
"postal_code": "",
"postal_address": "",
"phone_number": "+254712845631",
"name": "James Otieno Kamau",
"id_type": "National ID",
"id_number": "1028845317",
"gender": "Male",
"email": "james.kamau@horizonmail.co.ke"
}
],
"shares": [
{ "shares": 1000, "value": 1.0, "name": "Ordinary Shares" }
],
"encumbrances": []
},
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}Sole proprietor (bn) / beneficial owner (bo)
Sample request body for Sole proprietor (bn) / beneficial owner (bo):
{
"registration_number": "BN/2019/847261K",
"search_type": "bn",
"consent": true
}Sample response for Sole proprietor (bn) / beneficial owner (bo):
{
"success": true,
"response_code": 200,
"message": "Sole Proprietor verification successful",
"country": "ke",
"data": {
"registration_number": "BN/2019/847261K",
"business_name": "Kamau & Associates Consultancy",
"status": "Active",
"registration_date": "2020-01-15",
"postal_address": "P.O. Box 12345, Nairobi",
"physical_address": "123 Business Street, Nairobi",
"phone_number": "+254712845631",
"branch": null,
"email": "info@johnsbusiness.com",
"kra_pin": "P100000001T",
"verified": true,
"partners": [
{
"type": "Owner",
"shares": [],
"postal_code": "",
"postal_address": "",
"phone_number": "+254712845631",
"name": "James Otieno Kamau",
"id_type": "National ID",
"id_number": "1028845317",
"gender": "Male",
"email": "james.kamau@horizonmail.co.ke"
}
]
},
"request_id": "550e8400-e29b-41d4-a716-446655440001"
}Response Fields
Error codes
Standard Peleza HTTP / response_code values (same across all API calls). Validation message text is endpoint-specific. Full reference: Error Codes.
Invalid registration format
{
"success": false,
"response_code": 422,
"message": "Validation failed",
"country": "ke",
"errors": {
"registration_number": [
"Company registration numbers must start with PVT, PLC, or C and include a valid suffix"
]
},
"data": null,
"request_id": "550e8400-e29b-41d4-a716-446655440010"
}Business not found
{
"success": false,
"response_code": 404,
"message": "Business not found",
"country": "ke",
"data": null,
"request_id": "550e8400-e29b-41d4-a716-446655440011"
}Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.