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

# CIPC Company Lookup

> Retrieve registered company information and director details from the Companies and Intellectual Property Commission.

## Overview

These endpoints query the Companies and Intellectual Property Commission (CIPC) database to retrieve information about registered South African companies and their directors.

***

## Get Enterprise Information

```
POST /Citizen/CIPCCheckEnterprise
```

Returns registration details, status, and information about a CIPC-registered company.

```bash theme={null}
curl -X POST "https://citizen.uat.securecitizen.cloud/Citizen/CIPCCheckEnterprise" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ConsentReceived": true,
    "RegistrationNumber": "2010/123456/07",
    "CRef": "REF00001"
  }'
```

### Request Fields

| Field                | Type    | Required | Description                      |
| -------------------- | ------- | -------- | -------------------------------- |
| `ConsentReceived`    | boolean | **Yes**  | Must be `true`                   |
| `RegistrationNumber` | string  | **Yes**  | CIPC company registration number |
| `CRef`               | string  | No       | Your transaction reference       |

### Response

```json theme={null}
{
  "data": {
    "RegistrationNumber": "2010/123456/07",
    "CompanyName": "Example Company (Pty) Ltd",
    "CompanyStatus": "In Business",
    "CompanyType": "Private Company",
    "RegistrationDate": "2010-06-15",
    "BusinessStartDate": "2010-07-01",
    "FinancialYearEnd": "February",
    "RegisteredAddress": {
      "AddressLine1": "123 Main Street",
      "City": "Johannesburg",
      "Province": "Gauteng",
      "PostalCode": "2000",
      "Country": "South Africa"
    }
  },
  "Status": "Success",
  "CRef": "REF00001"
}
```

***

## Get Company Directors

```
POST /Citizen/CIPCCheckDirectors
```

Returns the list of directors and their details for a CIPC-registered company.

```bash theme={null}
curl -X POST "https://citizen.uat.securecitizen.cloud/Citizen/CIPCCheckDirectors" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ConsentReceived": true,
    "RegistrationNumber": "2010/123456/07",
    "CRef": "REF00001"
  }'
```

### Response

```json theme={null}
{
  "data": {
    "RegistrationNumber": "2010/123456/07",
    "CompanyName": "Example Company (Pty) Ltd",
    "Directors": [
      {
        "IdNumber": "8001014800080",
        "FirstName": "John",
        "LastName": "Doe",
        "DirectorStatus": "Active",
        "AppointmentDate": "2010-06-15",
        "DirectorType": "Director"
      }
    ]
  },
  "Status": "Success",
  "CRef": "REF00001"
}
```

### Director Response Fields

| Field             | Description                                                  |
| ----------------- | ------------------------------------------------------------ |
| `DirectorStatus`  | `Active`, `Resigned`, `Removed`, etc.                        |
| `AppointmentDate` | Date the director was appointed                              |
| `DirectorType`    | `Director`, `Alternate Director`, `Prescribed Officer`, etc. |