Organisation Resource Advanced

Direct corporate entity management for specialized scenarios

Organisation records store corporate entity data for trustees, fund managers, responsible entities, and investment companies. Most organisation management occurs through BizEntity operations. Direct Organisation endpoints support bulk imports, cross-entity queries, and data migration.

4
Endpoints
2
Core DTOs
46
Properties
Tax
Residency

Usage Notes

When

  • Manage organisation records independently of BizEntity for bulk imports
  • Query organisation details for corporate structure verification
  • Create standalone organisation records for later association with entities

Requirements

  • Valid Bearer token with organisation permissions

Notes

  • Organisation records typically created via BizEntity operations; use direct endpoints for specialized scenarios
  • Same externalOrganisationId across multiple BizEntity operations reuses ONE organisation record
  • Organisations link to BizEntity through BizEntityParty with corporate capacity types
  • Cannot delete organisations with active BizEntityParty relationships

Available Endpoints

Core Operations

GET Get Organisations Query with ABN/ACN validation
POST Create Organisation Create with registration and tax residency details
PUT Update Organisation Update maintaining associated persons
DELETE Delete Organisation Remove with relationship validation

Core Data Transfer Objects

OrganisationDTO All Organisation endpoints Corporate structure (46 properties) with ABN/ACN registration fields, FATCA/CRS data fields, tax residency (up to 3 jurisdictions), GIIN field, and 3 nested arrays (Addresses, Communications, AssociatedPersons)
BizEntityPartyDTO Entity relationships (referenced) Organisation-to-entity relationship links (13 properties) defining corporate roles, capacity types, and party associations within BizEntity hierarchies

Use Cases & Scenarios

Most organisation management occurs through BizEntity operations. Use direct Organisation endpoints for bulk corporate imports, cross-entity updates, or data migration scenarios.

→ See BizEntity Overview for standard entity operations

Business Rules & Constraints

BizEntity Integration & Deduplication

  • Automatic Deduplication: When creating organisations through BizEntity operations, the system automatically deduplicates based on externalOrganisationId
  • Reuse Pattern: Same externalOrganisationId in multiple locations within a BizEntity request creates ONE organisation record
  • Multi-role support: Organisation records link to BizEntity through BizEntityParty relationships with corporate capacity types
  • Associated persons: Track directors, shareholders, signatories, and beneficial owners with role-based relationships

Corporate Registration & Tax Information

  • ABN/ACN fields: 11-digit ABN and 9-digit ACN format fields for Australian business registration numbers
  • GIIN field: Global Intermediary Identification Number field for FATCA reporting financial institutions
  • FATCA/CRS data fields: Active/Passive NFFE type fields, Financial Institution category fields, and CRS participation data
  • Tax residency: Support for up to three tax jurisdictions with TIN fields and reason code fields

Referential Integrity & Management

  • Deletion restrictions: Organisation records cannot be deleted if active BizEntityParty relationships exist
  • External integration: ExternalOrganisationId supports third-party system integration and idempotency
  • Address management: Organisation addresses managed through nested arrays (Addresses, Communications, AssociatedPersons)
  • Trading name support: Business names different from registered legal entity names via TradingName field
  • Name identification: Name field stores registered legal entity name, Description field for additional context