👩‍💼Director CIPC Lookup

Complete a CIPC Directors List lookup based on the business registration number.

GET {{baseUrl}}/businesses/cipc/director?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 Directors List Lookup

{
    "CIPCDirectors": [
        {
            "IDNumber": "{{IDNumber}}",
            "IDNumberTen": "{{IDNumberTen}}",
            "RegistrationNumber": "201525556607",
            "CompanyName": "FINCH TECHNOLOGIES",
            "CompanyStatus": "03",
            "CompanyType": "Private Company",
            "CompanySize": "SME",
            "DirectorStatusCode": "A",
            "DirectorStatus": "Active",
            "MaxStatusDate": "2019-04-25",
            "PersonName": "{{FullName}}",
            "ResignationDate": "None",
            "AppointmentDate": "2019-04-25",
            "ValidID": true,
            "IDNameMatch": "",
            "Source": "CIPC",
            "Reference": "",
            "UsingExtraPersonDetails": false,
            "IsTreasuryRestrictedSupplier": "",
            "DirectorTypeCode": "D",
            "DirectorType": "Director",
            "Country": ""
        },
        {
            "IDNumber": "{{IDNumber}}",
            "IDNumberTen": "{{IDNumberTen}}",
            "RegistrationNumber": "201525556607",
            "CompanyName": "FINCH TECHNOLOGIES",
            "CompanyStatus": "03",
            "CompanyType": "Private Company",
            "CompanySize": "SME",
            "DirectorStatusCode": "C",
            "DirectorStatus": "Resigned",
            "MaxStatusDate": "2018-08-31",
            "PersonName": "{{FullName}}",
            "ResignationDate": "2018-08-31",
            "AppointmentDate": "2015-07-28",
            "ValidID": true,
            "IDNameMatch": "",
            "Source": "CIPC",
            "Reference": "",
            "UsingExtraPersonDetails": false,
            "IsTreasuryRestrictedSupplier": "",
            "DirectorTypeCode": "D",
            "DirectorType": "Director",
            "Country": ""
        },
        {
            "IDNumber": "8811285046084",
            "IDNumberTen": "8811285046",
            "RegistrationNumber": "201525556607",
            "CompanyName": "FINCH TECHNOLOGIES",
            "CompanyStatus": "03",
            "CompanyType": "Private Company",
            "CompanySize": "SME",
            "DirectorStatusCode": "A",
            "DirectorStatus": "Active",
            "MaxStatusDate": "2015-07-28",
            "PersonName": "{{FullName}}",
            "ResignationDate": "None",
            "AppointmentDate": "2015-07-28",
            "ValidID": true,
            "IDNameMatch": "",
            "Source": "CIPC",
            "Reference": "",
            "UsingExtraPersonDetails": false,
            "IsTreasuryRestrictedSupplier": "",
            "DirectorTypeCode": "D",
            "DirectorType": "Director",
            "Country": ""
        },
        {
            "IDNumber": "{{IDNumber}}",
            "IDNumberTen": "{{IDNumberTen}}",
            "RegistrationNumber": "201525556607",
            "CompanyName": "FINCH TECHNOLOGIES",
            "CompanyStatus": "03",
            "CompanyType": "Private Company",
            "CompanySize": "SME",
            "DirectorStatusCode": "A",
            "DirectorStatus": "Active",
            "MaxStatusDate": "2015-07-28",
            "PersonName": "{{FullName}}",
            "ResignationDate": "None",
            "AppointmentDate": "2015-07-28",
            "ValidID": true,
            "IDNameMatch": "",
            "Source": "CIPC",
            "Reference": "",
            "UsingExtraPersonDetails": false,
            "IsTreasuryRestrictedSupplier": "",
            "DirectorTypeCode": "D",
            "DirectorType": "Director",
            "Country": ""
        },
        {
            "IDNumber": "{{IDNumber}}",
            "IDNumberTen": "{{IDNumberTen}}",
            "RegistrationNumber": "201525556607",
            "CompanyName": "FINCH TECHNOLOGIES",
            "CompanyStatus": "03",
            "CompanyType": "Private Company",
            "CompanySize": "SME",
            "DirectorStatusCode": "A",
            "DirectorStatus": "Active",
            "MaxStatusDate": "2015-07-28",
            "PersonName": "{{FullName}}",
            "ResignationDate": "None",
            "AppointmentDate": "2015-07-28",
            "ValidID": true,
            "IDNameMatch": "",
            "Source": "CIPC",
            "Reference": "",
            "UsingExtraPersonDetails": false,
            "IsTreasuryRestrictedSupplier": "",
            "DirectorTypeCode": "D",
            "DirectorType": "Director",
            "Country": ""
        },
        {
            "IDNumber": "{{IDNumber}}",
            "IDNumberTen": "{{IDNumberTen}}",
            "RegistrationNumber": "201525556607",
            "CompanyName": "FINCH TECHNOLOGIES",
            "CompanyStatus": "03",
            "CompanyType": "Private Company",
            "CompanySize": "SME",
            "DirectorStatusCode": "A",
            "DirectorStatus": "Active",
            "MaxStatusDate": "2015-07-28",
            "PersonName": "{{FullName}}",
            "ResignationDate": "None",
            "AppointmentDate": "2015-07-28",
            "ValidID": true,
            "IDNameMatch": "",
            "Source": "CIPC",
            "Reference": "",
            "UsingExtraPersonDetails": false,
            "IsTreasuryRestrictedSupplier": "",
            "DirectorTypeCode": "D",
            "DirectorType": "Director",
            "Country": ""
        }
    ],
    "DirectorTotalRecords": 5,
    "DirectorTotalReturnedRecords": 6,
    "director_request_reference": "82e09726-2c0e-4f59-9b00-cbceef68be8b",
    "cipc_timestamp": "2024-08-14T07:29:57.944872Z"
}

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
IDNumber	String	The 13-digit South African ID Number.
RegistrationNumber	String	The company registration number the Customer is a director in. *Format YYYYNNNNNNNN
CompanyName	String	The company name the Consumer is a director in.
CompanyStatus	String	The operation status of the company the Consumer is a director in (see Company Status).
CompanyType	String
CompanySize	String	The size of the company the Consumer is a director in director in. *Small, SME, Medium, or Large
DirectorStatusCode	String	The director status code explaining the director position held by the Consumer in the company (see Director Status Code).
DirectorStatus	String	The director status explaining the directorship status of the Consumer in the company (see Director Status).
MaxStatusDate	Date	The last date the company status was updated from source.
PersonName	String	The Consumer's fullname
ResignationDate	Date	The Consumer's date of resignation from the director's position.
AppointmentDate	Date	The Consumer's date of appointment as a director.
Source	String	The source where the directorship details were obtained.
DirectorTotalRecords	Number	The count of active director records linked to the company registration number.
DirectorTotalReturnedRecords	Number	The count of all director records linked to the company registration number.
director_request_reference	UUID	The unique reference linked to the directors/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

Company Status

Company Status Descriptions

Director Status Code

Director Status Code Description

Director Status

Director Status Description