DELETE

/Organisation

When to Use

Remove organisations created with incorrect details
Clean up duplicate organisation records
Delete test organisations from development environments

Prerequisites

Organisation must have no active business relationships or trustee roles

Considerations

Only works when organisation has no BizEntity relationships or transaction history
All associated Address and Communication records automatically removed
Deletion is permanent with no recovery mechanism available
Associated person links removed but person records remain in system

Description

Permanently deletes an organisation record and all associated Address and Communication records. This operation follows strict business rules to prevent accidental deletion of organisations serving as corporate trustees or fund managers.

Advanced Resource: Organisation records are typically managed through BizEntity operations. Use this endpoint for direct organisation deletion only when the organisation has no active business relationships or for pre-investment cleanup purposes.

Organisation deletion will only work if the organisation has no BizEntityParty relationships, no transaction history, and no trustee roles. Only Address and Communication records are automatically deleted.

Required Headers - See Authentication

Header	Value	Description
Authorization	{accessToken}	Bearer token for API access
Version	2.0	API version identifier

Query Parameters

Parameter	Type	Required	Description
`OrganisationID` >	integer	> Conditional...	The native 7G identifier for the organisation to delete. Preferred for performance and direct system lookup.
`externalOrganisationId` >	string	> Conditional...	Your external identifier for the organisation to delete. Use when you cannot store 7G's native IDs.

OrganisationID

integer

> Conditional...

The native 7G identifier for the organisation to delete. Preferred for performance and direct system lookup.

externalOrganisationId

string

> Conditional...

Your external identifier for the organisation to delete. Use when you cannot store 7G's native IDs.

Example Requests

bash

# Delete by 7G ID
curl -X DELETE https://api.7g.com.au/Organisation?OrganisationID=12345 \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

# Delete by External ID
curl -X DELETE https://api.7g.com.au/Organisation?ExternalOrganisationId=CORP-001 \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

Response Examples

json

{
  "result": true,
  "message": "Organisation deleted successfully",
  "recordCount": 0,
  "data": null
}