Entity Stakeholders

The stakeholders array contains related parties involved with an entity, such as trustees, beneficiaries, and other roles. Stakeholder requirements vary by entity type.

Available stakeholder roles

The following roles can be assigned to stakeholders across all entity types:

Role	Label	Allowed Entity Types
`trustee`	Trustee	`individual`, `company`
`settlor`	Settlor	`individual`
`beneficiary`	Beneficiary	`individual`, `company`, `trust`
`appointer`	Appointer	`individual`
`protector`	Protector	`individual`

Required stakeholders by entity type

Entity Type	Required Stakeholder Role(s)
`trust`	`trustee` (required)
`company`	None
`partnership`	None
`soleTrader`	None
`association`	None
`cooperative`	None
`governmentBody`	None
`indigenousCorporation`	None
`other`	None

Stakeholder object structure

Each stakeholder in the stakeholders array must include:

Field	Type	Required	Description
`role`	string	Yes	The stakeholder's role (e.g., `trustee`, `beneficiary`).
`type`	string	Yes	Entity type (`individual`, `company`, `trust`, etc.).
`subType`	string	No	Entity sub-type (e.g., `discretionaryTrust`, `none`).
`country`	string	Yes	ISO3 country code.
`name`	string	Yes	Entity name or full name for individuals.
`identifiers`	object	No	Entity identifiers (ABN, ACN, etc.).
`addresses`	object	No	Entity addresses.

The stakeholder object follows the same field structure as the main entity, with type, subType, country, name, identifiers, and addresses at the same level as role.

Usage example

Trust with trustee (individual)

Trust with individual trustee

{
	"userId": "user-123",
	"country": "AUS",
	"type": "trust",
	"subType": "discretionaryTrust",
	"name": "Smith Family Trust",
	"industry": "Investment",
	"website": "https://example.com",
	"identifiers": {
		"abn": "12345678901"
	},
	"documents": [
		{
			"kind": "trustDeed",
			"mimeType": "application/pdf",
			"source": "url",
			"data": "https://your-storage.com/trust-deed.pdf"
		}
	],
	"stakeholders": [
		{
			"role": "trustee",
			"type": "individual",
			"country": "AUS",
			"name": "John Smith"
		}
	]
}

Trust with trustee (company)

Trust with corporate trustee

{
	"userId": "user-123",
	"country": "AUS",
	"type": "trust",
	"subType": "discretionaryTrust",
	"name": "Smith Family Trust",
	"industry": "Investment",
	"website": "https://example.com",
	"identifiers": {
		"abn": "12345678901"
	},
	"documents": [
		{
			"kind": "trustDeed",
			"mimeType": "application/pdf",
			"source": "url",
			"data": "https://your-storage.com/trust-deed.pdf"
		}
	],
	"stakeholders": [
		{
			"role": "trustee",
			"type": "company",
			"subType": "none",
			"country": "AUS",
			"name": "Smith Trustee Pty Ltd",
			"identifiers": {
				"acn": "123456789"
			},
			"addresses": {
				"registeredAddress": "123 Main St, Sydney NSW 2000"
			}
		}
	]
}

Trust with multiple stakeholders

Trust with trustee and beneficiary

{
	"userId": "user-123",
	"country": "AUS",
	"type": "trust",
	"subType": "discretionaryTrust",
	"name": "Smith Family Trust",
	"industry": "Investment",
	"website": "https://example.com",
	"identifiers": {
		"abn": "12345678901"
	},
	"documents": [
		{
			"kind": "trustDeed",
			"mimeType": "application/pdf",
			"source": "url",
			"data": "https://your-storage.com/trust-deed.pdf"
		}
	],
	"stakeholders": [
		{
			"role": "trustee",
			"type": "individual",
			"country": "AUS",
			"name": "John Smith"
		},
		{
			"role": "beneficiary",
			"type": "individual",
			"country": "AUS",
			"name": "Jane Smith"
		}
	]
}