Entity Addresses

The addresses object contains location information for an entity. Required and optional address fields vary by entity type.

Available address fields

Address Field	Description
`registeredAddress`	Official registered address of the entity.
`principalPlaceOfBusiness`	Main place of business operations.
`other`	Any other relevant address.

Required addresses by entity type

Entity Type	Required Address(es)	Optional Address(es)
`company`	`registeredAddress`	`principalPlaceOfBusiness`, `other`
`soleTrader`	`principalPlaceOfBusiness`	`registeredAddress`, `other`
`partnership`	`principalPlaceOfBusiness`	`registeredAddress`, `other`
`association`	`registeredAddress`	`principalPlaceOfBusiness`, `other`
`cooperative`	`registeredAddress`	`principalPlaceOfBusiness`, `other`
`governmentBody`	`registeredAddress`	`principalPlaceOfBusiness`, `other`
`trust`	None	`registeredAddress`, `principalPlaceOfBusiness`, `other`
`indigenousCorporation`	None	`registeredAddress`, `principalPlaceOfBusiness`, `other`
`other`	None	`registeredAddress`, `principalPlaceOfBusiness`, `other`

Usage example

Company with addresses

Company with registered and business address

{
	"userId": "user-123",
	"country": "AUS",
	"type": "company",
	"subType": "none",
	"name": "My Company Pty Ltd",
	"industry": "Technology",
	"website": "https://example.com",
	"identifiers": {
		"acn": "123456789",
		"abn": "12345678901"
	},
	"addresses": {
		"registeredAddress": "Level 10, 123 George St, Sydney NSW 2000",
		"principalPlaceOfBusiness": "456 Business Park, Melbourne VIC 3000"
	}
}

Sole trader with addresses

Sole trader with business address

{
	"userId": "user-123",
	"country": "AUS",
	"type": "soleTrader",
	"subType": "none",
	"name": "John Smith Trading",
	"industry": "Consulting",
	"website": "https://example.com",
	"identifiers": {
		"abn": "12345678901"
	},
	"addresses": {
		"principalPlaceOfBusiness": "123 Main St, Brisbane QLD 4000"
	}
}

Summary: Requirements by entity type

Entity Type	Required Stakeholder	Required Address	Required Document
`trust`	`trustee`	—	`trustDeed`
`partnership`	—	`principalPlaceOfBusiness`	`partnershipAgreement`
`company`	—	`registeredAddress`	—
`soleTrader`	—	`principalPlaceOfBusiness`	—
`association`	—	`registeredAddress`	—
`cooperative`	—	`registeredAddress`	—
`governmentBody`	—	`registeredAddress`	—
`indigenousCorporation`	—	—	—
`other`	—	—	—