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

# Business Registration

## Verify businesses using their Business Registration Number

Adhere's Business Registration endpoint allows you to retrieve verified company information, including directors, beneficial owners, and shareholding structure, using a valid Kenya business registration number.

### Request Endpoint

`POST` `{{BASE_URL}}/api/onboarding/kenya_kyc/business_registration/`

* **Media-Type:** `application/json`

### Status Codes

* **200 OK:** The request was successful, and the business details are returned successfully.
* **400 Bad Request:** The request could not be completed due to invalid or missing information.

#### Sample Payload

```json theme={null}
{
    "registration_number": "PVT-ABC123",
    "postal_code": "00100",
    "postal_address": "1234"
}
```

200 OK Response

```json theme={null}
{
    "status": "success",
    "data": {
        "valid": true,
        "success": true,
        "directors": [
            {
                "name": "JAMES KARIUKI MWANGI",
                "gender": "Male",
                "address": "P.O BOX 1234 NAIROBI",
                "id_type": "National ID",
                "id_number": "A12345678",
                "occupation": "Director",
                "nationality": "Citizen",
                "phone_number": "N/A",
                "date_of_birth": "N/A",
                "shareholdings": 10,
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 10
                    }
                ]
            },
            {
                "name": "GRACE WANJIKU ODHIAMBO",
                "gender": "Female",
                "address": "P.O BOX 5678 NAIROBI",
                "id_type": "National ID",
                "id_number": "B87654321",
                "occupation": "Director",
                "nationality": "Citizen",
                "phone_number": "N/A",
                "date_of_birth": "N/A",
                "shareholdings": 0,
                "shareholding_breakdown": []
            }
        ],
        "documents": {},
        "fiduciaries": [],
        "proprietors": [],
        "beneficial_owners": [
            {
                "name": "JAMES KARIUKI MWANGI",
                "gender": "Male",
                "address": "P.O BOX 1234 NAIROBI",
                "nationality": "Citizen",
                "phone_number": "N/A",
                "shareholdings": 10,
                "shareholder_type": "Individual",
                "registration_number": "N/A",
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 10
                    }
                ]
            },
            {
                "name": "KENYA TECH SOLUTIONS LIMITED",
                "gender": "N/A",
                "address": "N/A",
                "nationality": "N/A",
                "phone_number": "N/A",
                "shareholdings": 50,
                "shareholder_type": "Foreign_company",
                "registration_number": "1234567",
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 50
                    }
                ]
            },
            {
                "name": "EASTAFRICA KONSULT INTEGRATED SERVICES LIMITED",
                "gender": "N/A",
                "address": "N/A",
                "nationality": "N/A",
                "phone_number": "N/A",
                "shareholdings": 40,
                "shareholder_type": "Foreign_company",
                "registration_number": "7654321",
                "shareholding_breakdown": [
                    {
                        "type": "ORDINARY",
                        "number_of_shares": 40
                    }
                ]
            }
        ]
    },
    "message": "Business Registration details retrieved successfully"
}
```

400 Bad Request Response

```json theme={null}
{
    "status": "failed",
    "data": [],
    "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}
```