DELETE

/Organisation

When to Use

Corporate Dissolution: Remove dissolved companies or wound-up entities
Data Cleanup: Remove test organisations or duplicate records
Compliance Closure: Archive entities no longer operating or required
Error Correction: Remove organisations created in error before operational use
System Maintenance: Clean up unused entities for data integrity

Common Scenarios

ASIC Deregistration: Company deregistered by ASIC and no longer exists
Voluntary Dissolution: Company voluntarily wound up by shareholders
Test Data Cleanup: Remove UAT or development test organisations
Duplicate Resolution: Eliminate duplicate entries created by data imports
System Migration: Clean up entities that won't be migrated to new systems

Prerequisites

Valid Bearer token with organisation deletion permissions and elevated access rights
Organisation must exist and be accessible within your account scope
Verification that organisation has no active business relationships
Confirmation of no pending transactions or regulatory obligations
Legal authority to delete corporate entity records

Considerations

Strict Business Rules: Cannot delete organisations with active BizEntity, trustee, or fund management relationships
Cascade Deletion: All related addresses, communications, and associated person links are permanently removed
Irreversible Operation: Deletion is permanent - no recovery mechanism available
Regulatory Impact: May affect compliance reporting if organisation was involved in financial transactions
Audit Trail: Deletion events are logged for regulatory and audit purposes
Reference Integrity: System prevents deletion if organisation is referenced in active records

Description

Permanently deletes an organisation and all its associated data. This operation has strict business rules to prevent accidental deletion of organisations that are actively 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-operational cleanup purposes.

⚠️ Deletion Restrictions

Organisations cannot be deleted if they are:

Serving as corporate trustees for business entities
Linked to active BizEntity records
Associated with active financial services licenses
Referenced in transaction or distribution records

Note: Only organisations linked exclusively to Address and/or Communication records can be 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
}