# Create a Business without a Customer **`POST`** **`{{baseUrl}}/businesses`** {% hint style="info" %} It is important to note that, if you create a Business without a Customer, you will not be able to perform any of the Customer verifications and validations in Gathr that require a `customer_id`. Therefore, you will not be able to: 1. Generate a Customer Credit Report/Credit Report and Score 2. Collect personal \[consumer] Bank Statements and Transactions via Online Login or Manual Upload 3. Upload and Verify an Identity Document for Proof of Identification 4. Upload and Verify Address Documentation for Proof of Address. {% endhint %} ### Request Body
NameTypeDescription
name*StringThe registered Business name.
type*String

The type of company the Business is legally registered as.

Types of companies accepted: Private Company, Sole Proprietor, Public Company, Closed Corporation, Partnership, NGO, and Business Trust.

reg*String

Example:

  • Company registration number: xxxx/xxxxxx/xx
  • Customer RSA ID number: xxxxxxxxxxx
enterprise_num*String

Example:

  • Enterprise ID: Kxxxxxxxxxxxx
  • Customer UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
cipc_checkBooleanThe CIPC check is an additional feature that would need to be enabled and would come at an additional charge.
Popi*BooleanThis is used to store whether the Business has given you Consent under the Protection Of Personal Information (POPI) Act to continue with collecting their data and performing additional verifications in Gathr.
#### Suggested entries for Registration Number and Enterprise Number | Company/Business Type | Registration Number | Enterprise Number | | ---------------------- | ------------------------------------- | ----------------------------------------- | | **Private Company** | Company Registration Number | Company Registration Number | | **Public Company** | Company Registration Number | Company Registration Number | | **Sole Proprietor** | Customer RSA ID Number | Unique Company Identifier / Customer UUID | | **Closed Corporation** | Company Registration Number | Company Registration Number | | **Partnership** | RSA ID Number of one of the directors | Unique Company Identifier / Customer UUID | | **Business Trust** | Business Trust Number | Unique Company Identifier | | **NGO** | Company Registration Number | Company Registration Number | #### **Example 1 - Request without CIPC check** ```json { "name": "Finch Technologies (Pty) Ltd", "type": "Private Company", "reg": "2015/123456/23", "enterprise_num":"K2016513771", "popi": true } ``` #### Example 2 - Request with CIPC check ```json { "name": "Finch Technologies (Pty) Ltd", "type": "Private Company", "reg": "2015/123456/23", "enterprise_num": "K2016513771", "cipc_check":true, "popi": true } ``` ### Status Codes
201 - Created **Business without a Customer - Without CIPC** 
{
    "data": {
        "id": "9f6eec17-ba45-4a14-afa3-f7ddf1376d73",
        "name": "FINCH TECHNOLOGIES",
        "type": "Private Company",
        "reg": "2015/255566/07",
        "enterprise_num": "K201525556607",
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
**Business without a Customer - With CIPC - Business Verified** ```json { "data": { "id": "cf3b0b03-53cc-4f66-bc85-47061a44900b", "name": "FINCH TECHNOLOGIES", "type": "Private Company", "reg": "2015/255566/07", "enterprise_num": "K201525556607", "linked_customers": [], "cipc_business_verified": true, "cipc_director_verified": false, "cipc_information": { "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": "d1e5f06f-93b7-4cd4-8d16-a3ce6545340f", "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": "{{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": "" }, { "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": "68f58786-646c-44e9-877d-3b40c1281737" }, "cipc_timestamp": "2024-08-16T10:47:40.090038Z" } } ```
403 - Forbidden **CIPC module not enabled on tenant** ```json { "errors": { "error": "CIPC checks are not enabled for your tenant. Please contact support if you wish to enable the feature." } } ```
409 - Conflict **Business Not Unique** ```json { "errors": "Business not unique" } ```
422 - Unprocessable Content **Input Validation - Registration Number** ```json { "errors": { "reg": [ "The reg field is required." ] } } ``` ```json { "errors": { "reg": [ "Expected registration number xxxx/xxxxxx/xx or customer id number" ] } } ``` **Input Validation - Enterprise Number** ```json { "errors": { "enterprise_num": [ "The enterprise num field is required." ] } } ``` ```json { "errors": { "enterprise_num": [ "Expected enterprise number K/B/Mxxxxxxxxxxxx or guid v4" ] } } ``` **Input Validation - Business Type** ```json { "errors": { "type": [ "The accepted Business types include Private Company, Sole Proprietor, Public Company, Closed Corporation, Partnership, NGO, Business Trust" ] } } ```