PUT

/Organisation

When to Use

  • Director Changes: Update associated persons when directors join, leave, or change roles
  • Address Updates: Change registered office, business address, or postal details
  • Compliance Updates: Modify FATCA/CRS status, tax jurisdictions, or regulatory classifications
  • License Changes: Update AFSL, ARSN, or other regulatory identifiers
  • Contact Information: Change communication details for correspondence and notifications

Prerequisites

  • Valid Bearer token with organisation update permissions and appropriate scope
  • Current organisation record retrieved via GET operation (required for complete DTO)
  • Updated compliance documentation for regulatory changes
  • Director resolutions or corporate authority for structural changes
  • Verification of new contact details and addresses

Considerations

  • Complete DTO Required: PUT replaces entire record - retrieve current data via GET first
  • Array Replacement: All nested arrays (addresses, communications, persons) completely replaced
  • Mandatory Fields: organisationID required and must match existing record exactly
  • Immutable Fields: externalOrganisationId cannot be changed after creation
  • Regulatory Impact: Changes may trigger compliance notifications or regulatory reporting
  • Relationship Dependencies: Ensure associated persons exist in system before referencing

Description

Updates an existing organisation record with complete Organisation DTO replacement. Include all fields from the current record, modifying only the values that need to change.

Advanced Resource: Organisation records can be updated independently via this endpoint or managed through BizEntity operations. Use this endpoint for direct organisation modifications, director changes, or compliance-driven updates.

⚠️ Complete DTO Required

PUT operation requires the complete Organisation DTO including organisationID. Retrieve current record via GET first, modify needed fields, then submit the complete object.

Required Headers - See Authentication

HeaderValueDescription
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier
Content-Typeapplication/jsonContent type for request body

Request Body

Parameter Type Required Description
OrganisationID >
integer
The 7G identifier for the organisation to update
externalOrganisationId
 string?
Optional
Your external reference identifier for this organisation. Maximum 50 characters. Can be used instead of organisationID to identify the record for update. Enables bidirectional cross-reference between 7G platform and client systems. Critical for API integrations maintaining own organisation identifiers. Must be unique across system and cannot be changed after creation. Referenced in nested objects (addresses, communications, associatedPersons) to establish parent-child relationships using your identifier scheme.
name
 string?
Optional
Legal registered name as it appears on official registration documents. Maximum 255 characters. Must match ASIC registration for corporate trustees and PDS documentation for fund managers. System uses for regulatory filings, compliance documentation, and legal correspondence throughout Investment and Distribution operations. Use tradingName for business-as-usual name when organisation operates under different public name.
activeEntityReason
 string?
Optional
Explanation for Active NFFE (Non-Financial Foreign Entity) classification under FATCA/CRS. Documents why organisation qualifies based on operational activities like trading, manufacturing, or service provision. System stores for compliance documentation supporting Active NFFE status which reduces withholding and reporting obligations. Required when claiming Active NFFE treatment based on >50% active income or exchange listing.
afsl >
string?
Australian Financial Services License number issued by ASIC. Six-digit identifier authorizing financial services provision including fund management and investment advice. System uses for compliance monitoring, regulatory reporting, and responsible entity verification in managed investment schemes.
arsn >
string?
Australian Registered Scheme Number issued by ASIC for managed investment schemes. Nine-digit identifier verifying registration compliance under the Corporations Act 2001. System validates format and uses for responsible entity verification, scheme registration tracking, and Investment operations involving registered funds.
crsfatcaParticipationID >
integer
FATCA/CRS participation status classification. Essential for cross-border compliance and international tax reporting obligations.
customerCode
 string?
Optional
Internal customer reference code or account number for operational tracking and billing. Used for client relationship management, fee billing, and internal reporting. System stores for cross-referencing with accounting systems, CRM platforms, and billing workflows. Useful for fund managers categorizing clients or administrators tracking service fee arrangements.
description
 string?
Optional
Free-text description of organisation's business activities, operational purpose, or contextual information. Used for internal notes and client relationship details not captured in structured fields. System stores for reference by administrators, client service teams, and compliance officers. Useful for documenting special circumstances or relationship-specific details. Not used in regulatory reporting.
fatcaType >
string?
FATCA classification type defining organisation's status under US tax reporting. Common values include FFI (Foreign Financial Institution), NFFE (Non-Financial Foreign Entity), Participating FFI, and Exempt Beneficial Owner. System uses to determine US tax reporting obligations and withholding requirements for Investment operations involving US persons.
financialnstitutionType >
string?
Financial institution classification under FATCA/CRS frameworks. Common categories include Investment Entity, Custodial Institution, Depository Institution, or Investment Advisor. System uses to determine specific reporting obligations, due diligence requirements, and controlling person identification thresholds for cross-border operations.
foreignRegistrationPlace
 string?
Optional
Specific registration location within foreign jurisdiction where formation documents are filed. Captures state/province details beyond formationCountryCode (e.g., 'Delaware', 'Cayman Islands'). System stores for detailed formation documentation, regulatory verification, and legal jurisdiction specificity. Useful when state-level distinction required or when registered with specific foreign regulatory body. Referenced in cross-border entity verification.
formationCountryCode
 string?
Optional
ISO 3166-1 alpha-3 country code for legal formation jurisdiction. Exactly 3 characters (e.g., AUS, USA, GBR, CYM). System validates length and uses to determine legal jurisdiction, applicable corporate law, and regulatory oversight authority. Different from taxation country codes which reflect tax residence. Used in regulatory reporting, beneficial ownership analysis, and cross-border compliance. Essential for offshore formations operating with tax residence elsewhere.
giin >
string?
Global Intermediary Identification Number issued by IRS for FATCA reporting. Format: XXXXXX.XXXXX.XX.XXX. Required for financial institutions with US tax obligations. System validates format and uses for automated FATCA reporting and international tax compliance workflows.
identificationTypeID
 int?
Optional
Type of alternative identification document captured in identificationValue. Common types include Passport, Driver License, Business Registration Number, Foreign Tax ID, or Regulatory License. System uses to categorize supplementary identification beyond ABN/ACN/GIIN. Useful for foreign organisations or enhanced due diligence. Must be greater than 0 or null. Paired with identificationValue.
identificationValue
 string?
Optional
Actual identification number corresponding to identificationTypeID. Stores alternative identification for supplementary verification beyond ABN/ACN/GIIN. System uses for enhanced due diligence, foreign entity verification, and AML/CTF compliance. Critical for international organisations operating without ABN/ACN registration. Referenced in audit documentation and regulatory filings requiring alternative identification evidence.
isTrustee
 bool?
Optional
Indicates if organisation acts as trustee for SMSF, family trusts, or managed funds. Triggers enhanced compliance monitoring and regulatory oversight.
listedOnExchange
 string?
Optional
Stock exchange(s) where organisation's securities are publicly traded. Captures listing details such as 'ASX', 'NYSE', 'LSE', or multiple exchanges for cross-listed entities. System uses to identify publicly traded organisations qualifying for specific FATCA/CRS regulatory treatments. Critical for claiming reduced compliance obligations or Active NFFE status. May exempt from certain controlling person reporting requirements.
noABNACNReason >
string?
Explanation for absence of ABN or ACN. Common reasons include foreign entity status, government exemption, non-profit organisation, or below registration threshold. System stores for audit trail and ATO reporting to justify absence of standard Australian business identifiers.
noGIINReason >
string?
Explanation for absence of GIIN when organisation operates as financial institution. Common reasons include Deemed-Compliant FFI status, Exempt Beneficial Owner classification, or Non-Participating FFI status. System stores for FATCA compliance audit trail and determines appropriate withholding treatment.
nonReportingFinancialInstitutionType >
string?
Classification for financial institutions exempt from CRS reporting obligations. Categories include Governmental Entity, Central Bank, Retirement Fund, Exempt Collective Investment Vehicle, or Qualified Credit Card Issuer. System uses to exclude organisation from automatic CRS reporting while maintaining audit documentation.
noTINReason >
string?
Explanation for TIN absence in formation jurisdiction. Common reasons include formation in non-taxing jurisdiction, pending registration, exempt status, or special purpose vehicle classification. System stores for regulatory compliance documentation and audit trail when formation jurisdiction TIN unavailable.
organisationCategoryID
 int?
Optional
Functional category defining primary business purpose. Common categories include Fund Manager, Corporate Trustee, Responsible Entity, Investment Advisor, Custodian, or Registry Operator. System uses to determine regulatory workflows, compliance monitoring, and system permissions. Critical for establishing AFSL verification, responsible entity oversight, or trustee-specific compliance requirements. Must be greater than 0 if provided.
organisationTypeDate
 DateTime?
Optional
Date when organisation type classification became effective or last changed. Stored as smalldatetime. System uses to track structural changes such as incorporation of partnership or trust restructuring. Critical for audit trail and regulatory reporting requiring historical structure information. Useful for entities undergoing conversion from sole trader to company or unregistered to registered scheme.
organisationTypeID
 int?
Optional
Legal structure type classification. Common values include Company, Trust, Partnership, Sole Trader, Government Entity, or Non-Profit. System uses for regulatory classification, compliance requirements determination, and governance rules application. Critical for differentiating corporate trustees from trading companies. Must be greater than 0 if provided. Works with organisationCategoryID for complete profile.
abn >
string?
Australian Business Number issued by ATO. Exactly 11-digit identifier required for GST registration, invoicing, and tax compliance. System validates length and checksum, then uses for ATO reporting integration, tax invoice generation, and Distribution payment processing to Australian entities.
acn >
string?
Australian Company Number issued by ASIC upon company incorporation. Exactly 9-digit identifier for registered companies under the Corporations Act 2001. System validates length and uses for ASIC registry verification, corporate trustee validation in SMSF structures, and responsible entity verification for managed funds.
otherGIINReason >
string?
Additional explanation for GIIN absence when standard categories don't apply. Used for complex arrangements such as Qualified Intermediary agreements, transitional classifications, pending registration, or jurisdiction-specific IGA exemptions. System stores for comprehensive audit documentation.
taxationCountryCode >
string?
ISO 3166-1 alpha-3 country code for organisation's primary tax residence. Exactly 3 characters (e.g., AUS, USA, GBR). Required when tax residence differs from formation country. System validates length and uses for CRS/FATCA reporting, tax treaty determination, and withholding calculations on Investment distributions.
taxationCountry2Code >
string?
ISO 3166-1 alpha-3 country code for secondary tax residence. Exactly 3 characters. Used for dual-residence CRS reporting when organisation maintains tax obligations in multiple jurisdictions. Common for entities with permanent establishments in multiple countries. Paired with taxationCountryTIN2.
taxationCountry3Code >
string?
ISO 3166-1 alpha-3 country code for tertiary tax residence. Exactly 3 characters. Used for complex multi-jurisdiction CRS reporting. Applicable to multinational organisations with tax obligations in three or more jurisdictions. Paired with taxationCountryTIN3 for third jurisdiction identification.
taxationCountryTIN >
string?
Tax Identification Number issued by primary taxation jurisdiction in taxationCountryCode. Format varies by country (e.g., EIN for USA, UTR for UK). Required unless organisation qualifies for exemption in taxationCountryNoTINReason. System uses for CRS reporting, FATCA submissions, and Distribution tax documentation.
taxationCountryTIN2 >
string?
Tax Identification Number issued by secondary taxation jurisdiction in taxationCountry2Code. Required unless exempt per taxationCountryNoTINReason2. Used for dual-residence CRS reporting and multi-jurisdiction tax information exchange. System stores for automated reporting to secondary tax authority.
taxationCountryTIN3 >
string?
Tax Identification Number issued by tertiary taxation jurisdiction in taxationCountry3Code. Required unless exempt per taxationCountryNoTINReason3. Used for complex multi-residence CRS compliance and comprehensive automatic exchange reporting across all tax residence jurisdictions.
taxationCountryNoTINReason >
string?
Explanation for TIN absence in primary taxation jurisdiction. Common reasons include jurisdiction doesn't issue TINs, pending application, local exemption, or recent formation. System stores for CRS compliance audit trail and automatic exchange reporting to tax authorities.
taxationCountryNoTINReason2 >
string?
Explanation for TIN absence in secondary taxation jurisdiction. Common reasons include jurisdiction-specific issuance rules, pending registration, or local exemptions. System stores for dual-residence CRS compliance and multi-jurisdiction automatic exchange reporting.
taxationCountryNoTINReason3 >
string?
Explanation for TIN absence in tertiary taxation jurisdiction. System stores for complex CRS compliance involving three or more tax jurisdictions. Used in comprehensive automatic exchange reporting and audit documentation for multinational structures.
taxationFileNumber >
string?
Australian Tax File Number (TFN) issued by ATO for organisations. 9-digit identifier for Australian income tax, superannuation, and investment income reporting. Required to avoid 47% no-TFN withholding on distributions. System uses for automated withholding calculations, ATO reporting, and dividend imputation processing.
taxOfficeTypeID
 int?
Optional
Tax authority jurisdiction classification responsible for organisation's tax administration. Identifies which tax authority manages affairs such as specific ATO office, IRS division, or HMRC office. System uses for routing tax communications, determining reporting workflows, and establishing regulatory contact points. Must be greater than 0 or null.
tin >
string?
Tax Identification Number in organisation's formation jurisdiction. Used when formation country TIN differs from tax residence TINs. Common when organisation is formed in one jurisdiction (e.g., Cayman Islands, Delaware) but operates elsewhere. System uses for regulatory filings requiring formation jurisdiction tax details.
tradingName
 string?
Optional
Business trading name or 'doing business as' (DBA) name when different from legal registered name. Used for client-facing communications, marketing materials, and Distribution statements. Common for fund managers marketing under brand name while maintaining formal legal entity name for regulatory purposes. Legal name remains primary identifier for compliance.
trusteeGIIN >
string?
Global Intermediary Identification Number specific to organisation's trustee capacity. Used when organisation maintains separate IRS registration for trustee activities. Required for corporate trustees of FATCA-reportable trusts or SMSF structures with US investors. System uses for segregated FATCA reporting and dual-capacity compliance.
trusteeName >
string?
Legal name under which organisation operates as trustee. May differ from primary organisation name and typically includes 'as trustee for' clause. Required for SMSF corporate trustees where name must match ATO registrations. System uses for trust deed verification, ASIC filings, and Distribution payment documentation.
addresses
> List<AddressDTO>...
Optional
Organisation address collection for postal, business, and registered office purposes. Complete replacement of existing addresses - include all addresses to retain.
communications
> List<CommunicationDTO>...
Optional
Organisation communication methods for correspondence and compliance notifications. Complete replacement - include all communications to retain.
associatedPersons
> List<AssociatedPersonDTO>...
Optional
Key personnel associated with organisation including directors, signatories, and controlling persons. Complete replacement - include all associations to retain.
OrganisationID
integer
The 7G identifier for the organisation to update
externalOrganisationId
string?
Optional
Your external reference identifier for this organisation. Maximum 50 characters. Can be used instead of organisationID to identify the record for update. Enables bidirectional cross-reference between 7G platform and client systems. Critical for API integrations maintaining own organisation identifiers. Must be unique across system and cannot be changed after creation. Referenced in nested objects (addresses, communications, associatedPersons) to establish parent-child relationships using your identifier scheme.
name
string?
Optional
Legal registered name as it appears on official registration documents. Maximum 255 characters. Must match ASIC registration for corporate trustees and PDS documentation for fund managers. System uses for regulatory filings, compliance documentation, and legal correspondence throughout Investment and Distribution operations. Use tradingName for business-as-usual name when organisation operates under different public name.
activeEntityReason
string?
Optional
Explanation for Active NFFE (Non-Financial Foreign Entity) classification under FATCA/CRS. Documents why organisation qualifies based on operational activities like trading, manufacturing, or service provision. System stores for compliance documentation supporting Active NFFE status which reduces withholding and reporting obligations. Required when claiming Active NFFE treatment based on >50% active income or exchange listing.
afsl
string?
Australian Financial Services License number issued by ASIC. Six-digit identifier authorizing financial services provision including fund management and investment advice. System uses for compliance monitoring, regulatory reporting, and responsible entity verification in managed investment schemes.
arsn
string?
Australian Registered Scheme Number issued by ASIC for managed investment schemes. Nine-digit identifier verifying registration compliance under the Corporations Act 2001. System validates format and uses for responsible entity verification, scheme registration tracking, and Investment operations involving registered funds.
crsfatcaParticipationID
integer
FATCA/CRS participation status classification. Essential for cross-border compliance and international tax reporting obligations.
customerCode
string?
Optional
Internal customer reference code or account number for operational tracking and billing. Used for client relationship management, fee billing, and internal reporting. System stores for cross-referencing with accounting systems, CRM platforms, and billing workflows. Useful for fund managers categorizing clients or administrators tracking service fee arrangements.
description
string?
Optional
Free-text description of organisation's business activities, operational purpose, or contextual information. Used for internal notes and client relationship details not captured in structured fields. System stores for reference by administrators, client service teams, and compliance officers. Useful for documenting special circumstances or relationship-specific details. Not used in regulatory reporting.
fatcaType
string?
FATCA classification type defining organisation's status under US tax reporting. Common values include FFI (Foreign Financial Institution), NFFE (Non-Financial Foreign Entity), Participating FFI, and Exempt Beneficial Owner. System uses to determine US tax reporting obligations and withholding requirements for Investment operations involving US persons.
financialnstitutionType
string?
Financial institution classification under FATCA/CRS frameworks. Common categories include Investment Entity, Custodial Institution, Depository Institution, or Investment Advisor. System uses to determine specific reporting obligations, due diligence requirements, and controlling person identification thresholds for cross-border operations.
foreignRegistrationPlace
string?
Optional
Specific registration location within foreign jurisdiction where formation documents are filed. Captures state/province details beyond formationCountryCode (e.g., 'Delaware', 'Cayman Islands'). System stores for detailed formation documentation, regulatory verification, and legal jurisdiction specificity. Useful when state-level distinction required or when registered with specific foreign regulatory body. Referenced in cross-border entity verification.
formationCountryCode
string?
Optional
ISO 3166-1 alpha-3 country code for legal formation jurisdiction. Exactly 3 characters (e.g., AUS, USA, GBR, CYM). System validates length and uses to determine legal jurisdiction, applicable corporate law, and regulatory oversight authority. Different from taxation country codes which reflect tax residence. Used in regulatory reporting, beneficial ownership analysis, and cross-border compliance. Essential for offshore formations operating with tax residence elsewhere.
giin
string?
Global Intermediary Identification Number issued by IRS for FATCA reporting. Format: XXXXXX.XXXXX.XX.XXX. Required for financial institutions with US tax obligations. System validates format and uses for automated FATCA reporting and international tax compliance workflows.
identificationTypeID
int?
Optional
Type of alternative identification document captured in identificationValue. Common types include Passport, Driver License, Business Registration Number, Foreign Tax ID, or Regulatory License. System uses to categorize supplementary identification beyond ABN/ACN/GIIN. Useful for foreign organisations or enhanced due diligence. Must be greater than 0 or null. Paired with identificationValue.
identificationValue
string?
Optional
Actual identification number corresponding to identificationTypeID. Stores alternative identification for supplementary verification beyond ABN/ACN/GIIN. System uses for enhanced due diligence, foreign entity verification, and AML/CTF compliance. Critical for international organisations operating without ABN/ACN registration. Referenced in audit documentation and regulatory filings requiring alternative identification evidence.
isTrustee
bool?
Optional
Indicates if organisation acts as trustee for SMSF, family trusts, or managed funds. Triggers enhanced compliance monitoring and regulatory oversight.
listedOnExchange
string?
Optional
Stock exchange(s) where organisation's securities are publicly traded. Captures listing details such as 'ASX', 'NYSE', 'LSE', or multiple exchanges for cross-listed entities. System uses to identify publicly traded organisations qualifying for specific FATCA/CRS regulatory treatments. Critical for claiming reduced compliance obligations or Active NFFE status. May exempt from certain controlling person reporting requirements.
noABNACNReason
string?
Explanation for absence of ABN or ACN. Common reasons include foreign entity status, government exemption, non-profit organisation, or below registration threshold. System stores for audit trail and ATO reporting to justify absence of standard Australian business identifiers.
noGIINReason
string?
Explanation for absence of GIIN when organisation operates as financial institution. Common reasons include Deemed-Compliant FFI status, Exempt Beneficial Owner classification, or Non-Participating FFI status. System stores for FATCA compliance audit trail and determines appropriate withholding treatment.
nonReportingFinancialInstitutionType
string?
Classification for financial institutions exempt from CRS reporting obligations. Categories include Governmental Entity, Central Bank, Retirement Fund, Exempt Collective Investment Vehicle, or Qualified Credit Card Issuer. System uses to exclude organisation from automatic CRS reporting while maintaining audit documentation.
noTINReason
string?
Explanation for TIN absence in formation jurisdiction. Common reasons include formation in non-taxing jurisdiction, pending registration, exempt status, or special purpose vehicle classification. System stores for regulatory compliance documentation and audit trail when formation jurisdiction TIN unavailable.
organisationCategoryID
int?
Optional
Functional category defining primary business purpose. Common categories include Fund Manager, Corporate Trustee, Responsible Entity, Investment Advisor, Custodian, or Registry Operator. System uses to determine regulatory workflows, compliance monitoring, and system permissions. Critical for establishing AFSL verification, responsible entity oversight, or trustee-specific compliance requirements. Must be greater than 0 if provided.
organisationTypeDate
DateTime?
Optional
Date when organisation type classification became effective or last changed. Stored as smalldatetime. System uses to track structural changes such as incorporation of partnership or trust restructuring. Critical for audit trail and regulatory reporting requiring historical structure information. Useful for entities undergoing conversion from sole trader to company or unregistered to registered scheme.
organisationTypeID
int?
Optional
Legal structure type classification. Common values include Company, Trust, Partnership, Sole Trader, Government Entity, or Non-Profit. System uses for regulatory classification, compliance requirements determination, and governance rules application. Critical for differentiating corporate trustees from trading companies. Must be greater than 0 if provided. Works with organisationCategoryID for complete profile.
abn
string?
Australian Business Number issued by ATO. Exactly 11-digit identifier required for GST registration, invoicing, and tax compliance. System validates length and checksum, then uses for ATO reporting integration, tax invoice generation, and Distribution payment processing to Australian entities.
acn
string?
Australian Company Number issued by ASIC upon company incorporation. Exactly 9-digit identifier for registered companies under the Corporations Act 2001. System validates length and uses for ASIC registry verification, corporate trustee validation in SMSF structures, and responsible entity verification for managed funds.
otherGIINReason
string?
Additional explanation for GIIN absence when standard categories don't apply. Used for complex arrangements such as Qualified Intermediary agreements, transitional classifications, pending registration, or jurisdiction-specific IGA exemptions. System stores for comprehensive audit documentation.
taxationCountryCode
string?
ISO 3166-1 alpha-3 country code for organisation's primary tax residence. Exactly 3 characters (e.g., AUS, USA, GBR). Required when tax residence differs from formation country. System validates length and uses for CRS/FATCA reporting, tax treaty determination, and withholding calculations on Investment distributions.
taxationCountry2Code
string?
ISO 3166-1 alpha-3 country code for secondary tax residence. Exactly 3 characters. Used for dual-residence CRS reporting when organisation maintains tax obligations in multiple jurisdictions. Common for entities with permanent establishments in multiple countries. Paired with taxationCountryTIN2.
taxationCountry3Code
string?
ISO 3166-1 alpha-3 country code for tertiary tax residence. Exactly 3 characters. Used for complex multi-jurisdiction CRS reporting. Applicable to multinational organisations with tax obligations in three or more jurisdictions. Paired with taxationCountryTIN3 for third jurisdiction identification.
taxationCountryTIN
string?
Tax Identification Number issued by primary taxation jurisdiction in taxationCountryCode. Format varies by country (e.g., EIN for USA, UTR for UK). Required unless organisation qualifies for exemption in taxationCountryNoTINReason. System uses for CRS reporting, FATCA submissions, and Distribution tax documentation.
taxationCountryTIN2
string?
Tax Identification Number issued by secondary taxation jurisdiction in taxationCountry2Code. Required unless exempt per taxationCountryNoTINReason2. Used for dual-residence CRS reporting and multi-jurisdiction tax information exchange. System stores for automated reporting to secondary tax authority.
taxationCountryTIN3
string?
Tax Identification Number issued by tertiary taxation jurisdiction in taxationCountry3Code. Required unless exempt per taxationCountryNoTINReason3. Used for complex multi-residence CRS compliance and comprehensive automatic exchange reporting across all tax residence jurisdictions.
taxationCountryNoTINReason
string?
Explanation for TIN absence in primary taxation jurisdiction. Common reasons include jurisdiction doesn't issue TINs, pending application, local exemption, or recent formation. System stores for CRS compliance audit trail and automatic exchange reporting to tax authorities.
taxationCountryNoTINReason2
string?
Explanation for TIN absence in secondary taxation jurisdiction. Common reasons include jurisdiction-specific issuance rules, pending registration, or local exemptions. System stores for dual-residence CRS compliance and multi-jurisdiction automatic exchange reporting.
taxationCountryNoTINReason3
string?
Explanation for TIN absence in tertiary taxation jurisdiction. System stores for complex CRS compliance involving three or more tax jurisdictions. Used in comprehensive automatic exchange reporting and audit documentation for multinational structures.
taxationFileNumber
string?
Australian Tax File Number (TFN) issued by ATO for organisations. 9-digit identifier for Australian income tax, superannuation, and investment income reporting. Required to avoid 47% no-TFN withholding on distributions. System uses for automated withholding calculations, ATO reporting, and dividend imputation processing.
taxOfficeTypeID
int?
Optional
Tax authority jurisdiction classification responsible for organisation's tax administration. Identifies which tax authority manages affairs such as specific ATO office, IRS division, or HMRC office. System uses for routing tax communications, determining reporting workflows, and establishing regulatory contact points. Must be greater than 0 or null.
tin
string?
Tax Identification Number in organisation's formation jurisdiction. Used when formation country TIN differs from tax residence TINs. Common when organisation is formed in one jurisdiction (e.g., Cayman Islands, Delaware) but operates elsewhere. System uses for regulatory filings requiring formation jurisdiction tax details.
tradingName
string?
Optional
Business trading name or 'doing business as' (DBA) name when different from legal registered name. Used for client-facing communications, marketing materials, and Distribution statements. Common for fund managers marketing under brand name while maintaining formal legal entity name for regulatory purposes. Legal name remains primary identifier for compliance.
trusteeGIIN
string?
Global Intermediary Identification Number specific to organisation's trustee capacity. Used when organisation maintains separate IRS registration for trustee activities. Required for corporate trustees of FATCA-reportable trusts or SMSF structures with US investors. System uses for segregated FATCA reporting and dual-capacity compliance.
trusteeName
string?
Legal name under which organisation operates as trustee. May differ from primary organisation name and typically includes 'as trustee for' clause. Required for SMSF corporate trustees where name must match ATO registrations. System uses for trust deed verification, ASIC filings, and Distribution payment documentation.
addresses
> List<AddressDTO>...
Optional
Organisation address collection for postal, business, and registered office purposes. Complete replacement of existing addresses - include all addresses to retain.
communications
> List<CommunicationDTO>...
Optional
Organisation communication methods for correspondence and compliance notifications. Complete replacement - include all communications to retain.
associatedPersons
> List<AssociatedPersonDTO>...
Optional
Key personnel associated with organisation including directors, signatories, and controlling persons. Complete replacement - include all associations to retain.

Example Requests

json
{
  "organisationID": 123,
  "externalOrganisationId": "EXT-ABC-001",
  "name": "ABC Corporate Trustees Pty Ltd (Updated)",
  "activeEntityReason": "Active trading entity",
  "afsl": "123456",
  "arsn": "987654321",
  "crsfatcaParticipationID": 1,
  "customerCode": "ABC001",
  "description": "Corporate trustee for SMSF operations - updated description",
  "fatcaType": "NFFE",
  "financialnstitutionType": "Investment Entity",
  "foreignRegistrationPlace": null,
  "formationCountryCode": "AUS",
  "giin": "ABC123.AU.123.456",
  "identificationTypeID": 1,
  "identificationValue": "ACN123456789",
  "isTrustee": true,
  "listedOnExchange": null,
  "noABNACNReason": null,
  "noGIINReason": null,
  "nonReportingFinancialInstitutionType": null,
  "noTINReason": null,
  "organisationCategoryID": 2,
  "organisationTypeDate": "2023-01-15T00:00:00",
  "organisationTypeID": 1,
  "abn": "12345678901",
  "acn": "123456789",
  "otherGIINReason": null,
  "taxationCountryCode": "AUS",
  "taxationCountry2Code": null,
  "taxationCountry3Code": null,
  "taxationCountryTIN": "123456789",
  "taxationCountryTIN2": null,
  "taxationCountryTIN3": null,
  "taxationCountryNoTINReason": null,
  "taxationCountryNoTINReason2": null,
  "taxationCountryNoTINReason3": null,
  "taxationFileNumber": "12345678901",
  "taxOfficeTypeID": 1,
  "tin": "123456789",
  "tradingName": "ABC Trustees",
  "trusteeGIIN": "ABC123.AU.123.456",
  "trusteeName": "ABC Corporate Trustees Pty Ltd",
  "addresses": [
    {
      "addressID": 456,
      "addressTypeID": 1,
      "aboveAddressLine": "Suite 1501",
      "addressLine": "Level 15, 123 Collins Street",
      "suburb": "Melbourne",
      "postcode": "3000",
      "stateCode": "VIC",
      "countryCode": "AUS",
      "externalAddressId": null,
      "externalBizEntityId": null,
      "externalPersonId": null,
      "externalOrganisationId": "EXT-ABC-001",
      "personID": null,
      "bizEntityID": null,
      "organisationID": 123
    }
  ],
  "communications": [
    {
      "communicationID": 789,
      "externalCommunicationId": null,
      "communicationTypeID": 1,
      "name": "info@ABC-trustees.com.au",
      "bizEntityID": null,
      "externalBizEntityId": null,
      "personID": null,
      "externalPersonId": null,
      "organisationID": 123,
      "externalOrganisationId": "EXT-ABC-001"
    }
  ],
  "associatedPersons": [
    {
      "personID": 202,
      "externalPersonId": "EXT-PERSON-001",
      "isPrimaryContact": true,
      "employmentStatusID": 1,
      "relationshipTypeID": 2,
      "shareholdingPercentage": 100.00,
      "isSignatory": true,
      "isCRSFATCAControllingPerson": false
    }
  ]
}

Responses

json
{
  "result": true,
  "message": null,
  "recordCount": 1,
  "data": {
    "organisationID": 123,
    "externalOrganisationId": "EXT-ABC-001",
    "name": "ABC Corporate Trustees Pty Ltd (Updated)",
    "activeEntityReason": "Active trading entity",
    "afsl": "123456",
    "arsn": "987654321",
    "crsfatcaParticipationID": 1,
    "customerCode": "ABC001",
    "description": "Corporate trustee for SMSF operations - updated description",
    "fatcaType": "NFFE",
    "financialnstitutionType": "Investment Entity",
    "foreignRegistrationPlace": null,
    "formationCountryCode": "AUS",
    "giin": "ABC123.AU.123.456",
    "identificationTypeID": 1,
    "identificationValue": "ACN123456789",
    "isTrustee": true,
    "listedOnExchange": null,
    "noABNACNReason": null,
    "noGIINReason": null,
    "nonReportingFinancialInstitutionType": null,
    "noTINReason": null,
    "organisationCategoryID": 2,
    "organisationTypeDate": "2023-01-15T00:00:00",
    "organisationTypeID": 1,
    "abn": "12345678901",
    "acn": "123456789",
    "otherGIINReason": null,
    "taxationCountryCode": "AUS",
    "taxationCountry2Code": null,
    "taxationCountry3Code": null,
    "taxationCountryTIN": "123456789",
    "taxationCountryTIN2": null,
    "taxationCountryTIN3": null,
    "taxationCountryNoTINReason": null,
    "taxationCountryNoTINReason2": null,
    "taxationCountryNoTINReason3": null,
    "taxationFileNumber": "12345678901",
    "taxOfficeTypeID": 1,
    "tin": "123456789",
    "tradingName": "ABC Trustees",
    "trusteeGIIN": "ABC123.AU.123.456",
    "trusteeName": "ABC Corporate Trustees Pty Ltd",
    "addresses": [
      {
        "addressID": 456,
        "externalAddressId": null,
        "addressTypeID": 1,
        "aboveAddressLine": "Suite 1501",
        "addressLine": "Level 15, 123 Collins Street",
        "suburb": "Melbourne",
        "postcode": "3000",
        "stateCode": "VIC",
        "countryCode": "AUS",
        "externalBizEntityId": null,
        "externalPersonId": null,
        "externalOrganisationId": "EXT-ABC-001",
        "personID": null,
        "bizEntityID": null,
        "organisationID": 123
      }
    ],
    "communications": [
      {
        "communicationID": 789,
        "externalCommunicationId": null,
        "communicationTypeID": 1,
        "name": "info@ABC-trustees.com.au",
        "bizEntityID": null,
        "externalBizEntityId": null,
        "personID": null,
        "externalPersonId": null,
        "organisationID": 123,
        "externalOrganisationId": "EXT-ABC-001"
      }
    ],
    "associatedPersons": [
      {
        "personID": 202,
        "externalPersonId": "EXT-PERSON-001",
        "isPrimaryContact": true,
        "employmentStatusID": 1,
        "relationshipTypeID": 2,
        "shareholdingPercentage": 100.00,
        "isSignatory": true,
        "isCRSFATCAControllingPerson": false
      }
    ]
  }
}
GET Get Organisations POST Create Organisation DELETE Delete Organisation