GET

/Organisation

When to Use

Retrieve organisation records by organisationID or externalOrganisationId
Access corporate trustee details and director information
Validate FATCA/CRS reporting data and tax jurisdiction information
Review organisation structure for cross-entity relationships

Common Scenarios

Corporate Trustee Verification: Confirm trustee details before SMSF investments
Compliance Validation: Verify AFSL, ARSN, and regulatory identifiers
Director Disclosure: Review associated persons for controlling person identification
FATCA/CRS Reporting: Access tax jurisdiction and GIIN information
AML/CTF Checks: Verify organisation identity and beneficial ownership

Prerequisites

Valid Bearer token with organisation read permissions
OrganisationID or ExternalOrganisationId to identify the organisation
Understanding of organisation role in investment structure

Considerations

Direct Lookup Only: Returns single organisation - no filtering or bulk operations
Performance: Native OrganisationID provides faster retrieval than external references
Complete Structure: Includes all nested relationships (addresses, communications, persons)
Compliance Data: Returns full FATCA/CRS, AFSL, and tax identification details
Associated Persons: Includes directors, signatories, and controlling persons with relationship details

Description

Retrieves the complete Organisation DTO for a specific organisation record. Returns all organisation details including addresses, communications, associated persons, and regulatory compliance information.

Advanced Resource: Organisation records are typically created and managed through BizEntity operations, but can be accessed independently via this endpoint for verification, corporate trustee validation, or compliance purposes.

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. Preferred for performance and direct system lookup.
`externalOrganisationId` >	string	> Conditional...	Your external identifier for the organisation record. Use when you cannot store 7G's native IDs.

OrganisationID

integer

> Conditional...

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

externalOrganisationId

string

> Conditional...

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

Parameter Requirements

Either organisationID or externalOrganisationId must be provided to identify the organisation record to retrieve.

Example Requests

bash

# Get organisation by native ID
curl -X GET "https://api.7g.com.au/Organisation?OrganisationID=123" \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

# Get organisation by external ID
curl -X GET "https://api.7g.com.au/Organisation?ExternalOrganisationId=EXT-ORG-001" \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

Responses

json

{
  "result": true,
  "message": null,
  "recordCount": 1,
  "data": {
    "organisationID": 123,
    "externalOrganisationId": "EXT-ORG-001",
    "name": "ABC Corporate Trustees Pty Ltd",
    "activeEntityReason": "Active trading entity",
    "afsl": "123456",
    "arsn": "987654321",
    "crsfatcaParticipationID": 1,
    "customerCode": "ABC001",
    "description": "Corporate trustee for SMSF operations",
    "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,
    "taxationCountry2Code": null,
    "taxationCountry3Code": null,
    "taxationCountryCode": "AUS",
    "taxationCountryNoTINReason": null,
    "taxationCountryNoTINReason2": null,
    "taxationCountryNoTINReason3": null,
    "taxationCountryTIN": "123456789",
    "taxationCountryTIN2": null,
    "taxationCountryTIN3": null,
    "taxationFileNumber": "12345678901",
    "taxOfficeTypeID": 1,
    "tin": "123456789",
    "tradingName": "ABC Trustees",
    "trusteeGIIN": "ABC123.AU.123.456",
    "trusteeName": "ABC Corporate Trustees Pty Ltd",
    "addresses": [
      {
        "addressID": 456,
        "addressLine": "Level 15, 123 Collins Street",
        "aboveAddressLine": null,
        "suburb": "Melbourne",
        "stateCode": "VIC",
        "postcode": "3000",
        "countryCode": "AUS",
        "addressTypeID": 1
      }
    ],
    "communications": [
      {
        "communicationID": 789,
        "name": "info@ABC-trustees.com.au",
        "communicationTypeID": 1,
        "isPrimary": true
      }
    ],
    "associatedPersons": [
      {
        "personID": 202,
        "externalPersonId": "EXT-PERSON-001",
        "isPrimaryContact": true,
        "employmentStatusID": 1,
        "relationshipTypeID": 2,
        "shareholdingPercentage": 100.00,
        "isSignatory": true,
        "isCRSFATCAControllingPerson": false
      }
    ]
  }
}