Business Checks
# Introduction
This helps verify business registration and ownership:
# Request Parameters
The following parameters are expected:
| Field | Description | Type |
|---|---|---|
| search_type | The Spincrunch Search type you want to do. COMPANYSEARCHREGNO | String |
| identifier | The business registration number you want to verify against the phone number | String |
| consent | Indicates whether the data owner has consented to identity verification 1 if yes 0 if no. | String |
| consent_collected_by | Name or identifier of the person who provided the data owner’s consent. | String |
Please find sample implementation on the left
# Response Parameters
Below is a sample response
# companysearchregno Search
'search_type' is
COMPANYSEARCHREGNO,identifieris the business registration number
Search details on a business. A sample response is as follows:
{
"response_code": "200",
"success": true,
"message": "Business verification successful",
"data": {
"Data": {
"response": {
"status": "ok",
"infomsg": "ReportGenerated",
"Strategy": {
"Id": "XXXXXX",
"Name": "Company CBS UBO Data",
"BeeStrategy": "BRSCompanyReport",
"TemplateName": "BRS_RED_Template",
"SubscriberId": "XXXXXX",
"ReturnOutputDataInSteps": "false"
},
"ConsolidatedReport": {
"IdmIdentifyAfrica": {
"status": "ok",
"data": {
"response": {
"success": "true",
"response_code": "200",
"message": "Business Details with UBO Fetched Successfully",
"data": {
"status": "registered",
"registration_date": "27 December 2019",
"postal_address": "XXXXXX - XXXXXX",
"physical_address": "XXXXXX, XXXXXX, Fl: XXXXXX, XXXXXX",
"phone_number": "XXXXXX",
"share_capital": {
"number_of_shares": "1000",
"nominal_value": "100",
"name": "ORDINARY"
},
"registration_number": "XXXXXX",
"partners": [
{
"type": "shareholder",
"shares": {
"number_of_shares": "1000",
"name": "ORDINARY"
},
"postal_code": null,
"postal_address": "XXXXXX",
"phone_number": "XXXXXX",
"name": "XXXXXX",
"id_type": "foreign_company",
"id_number": "XXXXXX",
"gender": null,
"email": "XXXXXX"
},
{
"type": "beneficial_owner",
"postal_code": "XXXXXX",
"postal_address": "XXXXXX",
"phone_number": "XXXXXX",
"name": "XXXXXX",
"id_type": "citizen",
"id_number": "XXXXXX",
"gender": "F",
"email": "XXXXXX"
},
{
"type": "beneficial_owner",
"postal_code": "XXXXXX",
"postal_address": "XXXXXX",
"phone_number": "XXXXXX",
"name": "XXXXXX",
"id_type": "citizen",
"id_number": "XXXXXX",
"gender": "M",
"email": "XXXXXX"
},
{
"type": "director",
"postal_code": "XXXXXX",
"postal_address": "XXXXXX",
"phone_number": "XXXXXX",
"name": "XXXXXX",
"id_type": "citizen",
"id_number": "XXXXXX",
"gender": "M",
"email": "XXXXXX"
},
{
"type": "director",
"postal_code": "XXXXXX",
"postal_address": "XXXXXX",
"phone_number": "XXXXXX",
"name": "XXXXXX",
"id_type": "citizen",
"id_number": "XXXXXX",
"gender": "F",
"email": "XXXXXX"
}
],
"kra_pin": "XXXXXX",
"email": "XXXXXX",
"business_name": "XXXXXX",
"beneficial_owners": {
"name": "XXXXXX",
"type": "beneficial_owner",
"id_type": "foreign_company",
"id_number": "XXXXXX",
"ownership_percentage": "100"
},
"ubo_summary": {
"total_shares": "1000",
"threshold_percentage": "10",
"api_identified_count": "2",
"calculated_count": "1",
"total_ubos": "3"
}
},
"request_id": "XXXXXX"
}
}
},
"KenCB5": null
}
},
"Timestamp": "2025-09-17T07:31:46.9420949Z",
"source": "creditinfo"
}
}
}