GET

/Organisation

When to Use

Retrieve organisation records by organisationID or externalOrganisationId
Verify corporate trustee details before SMSF transactions
Access organisation details for cross-entity relationship management
Look up organisation information independently of BizEntity operations

Prerequisites

OrganisationID or ExternalOrganisationId to identify the organisation

Considerations

Returns complete organisation data with nested addresses, communications, and associated persons arrays
OrganisationID provides faster lookup than ExternalOrganisationId
Includes full tax identification and international compliance details

Description

Retrieves a specific organisation record from the 7G platform using either organisationID or externalOrganisationId. Returns the complete organisation data structure including all nested addresses, communications, and associated persons.

Advanced Resource: Organisation records are typically created and managed through BizEntity operations, but can be accessed independently via this endpoint for verification, cross-entity lookups, 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
      }
    ]
  }
}