GET

/organisation

Usage Notes

When

Retrieve organisation by organisationID or externalOrganisationId
Verify corporate details before trustee transactions
Access organisation data for cross-entity relationship queries

Requirements

OrganisationID or ExternalOrganisationId to identify the record

Notes

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

Description

Retrieves an organisation record with all corporate fields, nested addresses, communications, and associated persons. Supports lookup by native organisationID or externalOrganisationId.

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
      }
    ]
  }
}