Skip to main content

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.

​
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. 
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

FieldTypeRequiredDescription
ConsentReceivedbooleanYesMust be true
RegistrationNumberstringYesCIPC company registration number
CRefstringNoYour transaction reference

​
Response

{
  "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. 
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

{
  "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

FieldDescription
DirectorStatusActive, Resigned, Removed, etc.
AppointmentDateDate the director was appointed
DirectorTypeDirector, Alternate Director, Prescribed Officer, etc.