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

Any role from the stakeholder roles reference can be assigned to a stakeholder of any entity type (individual, company, trust, etc.). Roles are not restricted by the stakeholder's entity type — a trust may name an individual or a corporate trustee, for example. The only structural requirement is that a trust entity includes at least one trustee (see below).

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
`roles`	string[]	Yes	The stakeholder's roles (e.g., `["trustee"]`, `["director", "shareholder"]`).
`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 roles.

Deprecated: a single scalar role (string) is still accepted in place of roles for backwards compatibility and is treated as a one-element set. Prefer roles. If both are provided they must agree: the scalar role must be included in roles, otherwise the request is rejected.

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": [
		{
			"roles": ["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": [
		{
			"roles": ["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": [
		{
			"roles": ["trustee"],
			"type": "individual",
			"country": "AUS",
			"name": "John Smith"
		},
		{
			"roles": ["beneficiary"],
			"type": "individual",
			"country": "AUS",
			"name": "Jane Smith"
		}
	]
}