⬆️Update Business

The Business information may be updated if required.

Update Business

PATCH {{baseUrl}}/businesses/:business_id

The Business Name can be changed/updated whilst maintaining the same business_id.

Path Parameters

Name	Type	Description
business_id*	String	The UUID for a specific business that gets generated and returned in either POST Create a Business for a Customer or POST Create a Business without a Customer

Request Body

Name	Type	Description
name	String	The registered Business name.
reg	String	The Business Registration Number. Example: xxxx / xxxxxx / xx
enterprise_num	String	The Business Enterprise Number. Example: Kxxxxxxxxxx
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

200: OK Business name change

```postman_json
{
    "data": {
        "id": "{{businessId}}",
        "name": "Changed Business Name",
        "type": "Private Company",
        "reg": "xxxx/xxxxxx/xx",
        "enterprise_num": "Kxxxxxxxxxx",
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
```

200: OK Registration number change

```postman_json
{
    "data": {
        "id": "{{businessId}}",
        "name": "Changed Business Name",
        "type": "Private Company",
        "reg": "xxxx/xxxxnn/xx",
        "enterprise_num": "K2018535995",
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
```

200: OK Enterprise number change

```postman_json
{
    "data": {
        "id": "{{businessId}}",
        "name": "Changed Business Name",
        "type": "Private Company",
        "reg": "xxxx/xxxxnn/xx",
        "enterprise_num": "K20xxxxxxx",
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
```

200: OK Business type change

```postman_json
{
    "data": {
        "id": "{{businessId}}",
        "name": "Changed Business Name",
        "type": "Public Company",
        "reg": "xxxx/xxxxnn/xx",
        "enterprise_num": "K20xxxxxxx",
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
```

404: Not Found Missing businessId

```json
{
    "errors": {
        "code": "entity_not_found",
        "message": "Record not found in businesses"
    }
}
```

Before: Available Business Information

```postman_json
{
    "data": {
        "id": "{{businessId}}",
        "name": "Finch Technologies",
        "type": "Private Company",
        "reg": "2015/123456/23",
        "enterprise_num":"K2016513771"
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
```

Patch: Updating the business name and business type

```postman_json
{
        "name": "Finch Technologies PTY LTD",
        "type": "Public Company"
}
```

After: Updated Business Information

```postman_json
{
    "data": {
        "id": "{{businessId}}",
        "name": "Finch Technologies PTY LTD",
        "type": "Public Company",
        "reg": "2015/123456/23",
        "enterprise_num":"K2016513771"
        "linked_customers": [],
        "cipc_business_verified": false,
        "cipc_director_verified": false,
        "cipc_information": null,
        "cipc_timestamp": null
    }
}
```