🏤Business CIPC Lookup

Complete a CIPC Enterprise lookup based on the business registration number.

GET {{baseUrl}}/businesses/cipc/enterprise?registration_number=

Query Parameters

Key	Value	Description
registration_number*	String	The business registration number is required to complete an enterprise CIPC lookup. registration_number format: YYYYNNNNNNNN

API Responses

200 - OK

Successful Enterprise Lookup

{
    "CIPCEnterprises": [
        {
            "RegistrationNumber": "201525556607",
            "EnterpriseNumber": "K2015/255566/07",
            "EnterpriseName": "FINCH TECHNOLOGIES",
            "ShortName": "",
            "RegistrationDate_OnFile": "28072015",
            "BusinessStartDate_OnFile": "28072015",
            "StatusCode": "03",
            "StatusDate": "",
            "Status": "In Business",
            "Sic_Code": "",
            "Sic_Code_Description": "BUSINESS ACTIVITIES NOT RESTRICTED.",
            "FinancialYearEnd": 2,
            "FinancialYearEnd_EffectiveDate": "",
            "PhysicalAddressLine1": "8 MELVILLE ROAD",
            "PhysicalAddressLine2": "ILLOVO",
            "PhysicalAddressLine3": "GAUTENG",
            "PhysicalAddressLine4": "",
            "PhysicalAddressPostCode": "2196",
            "PostalAddressLine1": "PO BOX 5675",
            "PostalAddressLine2": "WALMER",
            "PostalAddressLine3": "PORT ELIZABETH",
            "PostalAddressLine4": "",
            "PostalAddressPostCode": "6070",
            "CountryCode": "ZA",
            "TaxNumber": "9005229258",
            "RegistrationDate": "2015-07-28",
            "BusinessStartDate": "2015-07-28",
            "RecordDate": "2023-09-29",
            "Source": "CIPC",
            "Reference": "",
            "CompanyTypeCode": "07",
            "CompanyType": "Private Company",
            "ChangeTypeCode": "",
            "ChangeType": "",
            "TelephoneNumber": []
        }
    ],
    "EnterpriseTotalRecords": 1,
    "EnterpriseTotalReturnedRecords": 0,
    "enterprise_request_reference": "ca96841b-e63a-4d03-9596-ee541ea6e95b",
    "cipc_timestamp": "2024-08-14T07:15:48.407478Z"
}

400 - Bad Request

Invalid Test Entity

In our UAT environment we have whitelisted a set of registration numbers for testing purposes only. Any registration number that is not whitelisted in our UAT environment will return the below error

{
    "errors": {
        "registration_number": [
            "Invalid test entity YYYYNNNNNNNN"
        ]
    }
}

403 - Forbidden

CIPC Module not enabled

{
    "errors": {
        "error": "CIPC checks are not enabled for your tenant. Please contact support if you wish to enable the feature."
    }
}

422 - Unprocessable Content

Input Validation Error

The input validations are as follows:

• Number of digits - the registration number must be 12 digits

• No special characters or letters will be accepted

• Year validation - the first 4 digits can not exceed the current year

{
    "errors": {
        "registration_number": [
            "The registration number format is invalid. The expected registration number format is YYYYNNNNNNNN."
        ]
    }
}

Request Validation Error

The request validations are as follows:

• Query parameter registration_number not selected

• No value included for the registration_number

{
    "errors": {
        "registration_number": [
            "Registration number is required."
        ]
    }
}

API Response Field Descriptions

Variable Name	Type	Description
RegistrationNumber	String	The business registration number.
EnterpriseNumber	String	The business enterprise number.
EnterpriseName	String	The full name of the enterprise.
ShortName	String	The short name of the enterprise.
RegistrationDate_OnFile	Date	The enterprise registration date on record. *DDMMYYYY
BusinessStartDate_OnFile	Date	The business operation start date on record. *DDMMYYYY
StatusCode	String	The trading status code of the enterprise (see Status Code).
StatusDate	Date	The date the enterprise trading status was recorded. *YYYY-MM-DD
Status	String	The trading status of the enterprise.
Sic_Code	String	Code indicator of the industry the enterprise operates in.
Sic_Code_Description	String	The description of the enterprise’s SIC code.
FinancialYearEnd	String	The financial year end of the enterprise.
FinancialYearEnd_EffectiveDate	String	The financial year end start date for the enterprise.
PhysicalAddressLine1	String	The physical address line 1 of the enterprise.
PhysicalAddressLine2	String	The physical address line 2 of the enterprise.
PhysicalAddressLine3	String	The physical address line 3 of the enterprise.
PhysicalAddressLine4	String	The physical address line 4 of the enterprise.
PhysicalAddressPostCode	String	The physical address area code of the enterprise.
PostalAddressLine1	String	The postal address box number of the enterprise.
PostalAddressLine2	String	The postal address line 2 of the enterprise.
PostalAddressLine3	String	The postal address line 3 of the enterprise.
PostalAddressLine4	String	The postal address line 4 of the enterprise.
PostalAddressPostCode	String	The postal address area code of the enterprise.
CountryCode	String	The country code of the enterprise's location.
TaxNumber	String	The tax number for the enterprise.
RegistrationDate	Date	The registration date of the enterprise.enquiry was placed. *YYYY-MM-DD
BusinessStartDate	Date	The enterprise start trade date. *YYYY-MM-DD
RecordDate	Date	The last date the enterprise details appeared in source records. *YYYY-MM-DD
Source	String	The source where the enterprise details were obtained.
enterpriseTypeCode	String	The enterprise type code. (see Enterprise Type Code)
enterpriseType	String	The enterprise type description.
ChangeTypeCode	String	The enterprise change type code. (see Change Type Code)
ChangeType	String	The enterprise change type description.
TelephoneNumber	String	The contact number of the enterprise.
EnterpriseTotalRecords	Number	The count of active director records linked to the company registration number.
EnterpriseTotalReturnedRecords	Number	The count of all enterprise records linked to the business registration number.
enterprise_request_reference	UUID	The unique reference linked to the enterprises/list CIPC enquiry.
cipc_timestamp	Date and Time	The date and time the directors/list CIPC enquiry was placed. *YYYY-MM-DDT00:00:00.000000Z

Status Code

Status Code Description

Enterprise Type Code

Enterprise Type code Description

Change Type Code

Change Code Type Description