👩‍💼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

Director Status Code

Director Status

Last updated 5 months ago

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

Query Parameters

API Responses

API Response Field Descriptions

Company Status

Director Status Code

Director Status

`GET` `{{baseUrl}}/businesses/cipc/director?registration_number=`