KYC verification for unregulated trusts (AUS)

Use this API call to perform KYC verification of unregulated trusts.

Parameters

NameTypeDescription
country
(required)		string3 letter country ISO
name
(required)		string
abn
string
unRegulatedTrustType
(required)		stringfamilyTrust / charitableTrust / testamentaryTrust / unitTrust / otherType
registeredOfficeRequired
(required)		stringaddress
trustDeed
(required)		stringbase64 Data URI (JPG/PNG/PDF)
stakeholders
(required)		arraybeneficiaries / trustee (*) / settlors

unRegulatedTrustTypes options

OptionDescription
familyTrust
Family Trust
charitableTrust
Charitable Trust
testamentaryTrust
Testamentary Trust
unitTrust
Unit Trust
otherType
Other Type

Stakeholder types

NameTypeNote
beneficiaries
individual
trustee
(required)		individual, privateCompany, publicCompany, governmentBody
settlors
individual

Note

Base64 encoded uploads must be submitted as a Data URI (with data format prefix). Example PDF format:

data:application/pdf;base64,JVBERi0xLjUKJYCBgoMKMSAwIG9i...

Runnable example


// api endpoint
const apiEndpoint = 'https://dev.bronid.com/verify';

// request body
const kycData = {
	"metadata_version": "4",
	"metadata_serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
	"metadata_secretKey": "api_sec_NJAtNcRtUrPlf7xYDrMNP9URI-ZfN314",
	"metadata_userId": "yourUniqueUserId",
	
	"type": "unRegulatedTrust",
	"fields": {
		"country": "AUS",
		"name": "My Unregulated Trust",
		"abn": "123456789",
		"unRegulatedTrustType": "familyTrust",
		"registeredOfficeRequired": "125 York Street, SYDNEY NSW 2000",
		"trustDeed": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
	},
	"stakeholders": [
		{
			"type": "individual",
			"role": "beneficiaries",
			"fields": {
				"firstName": "Jane",
				"middleName": "ok",
				"lastName": "Citizen",
				"gender": "female",
				"dateOfBirth": "20/12/1982",
				"unitNumber": "1",
				"streetNumber": "95",
				"streetName": "Lennox",
				"streetType": "Street",
				"suburb": "CASINO",
				"postcode": "2470",
				"state": "NSW",
				"email": "email@gmail.com",
				"country": "AUS"
			}
		},
		{
			"type": "individual",
			"role": "trustee",
			"fields": {
				"firstName": "Dave",
				"middleName": "ok",
				"lastName": "Citizen",
				"gender": "male",
				"dateOfBirth": "20/12/1982",
				"unitNumber": "1",
				"streetNumber": "95",
				"streetName": "Lennox",
				"streetType": "Street",
				"suburb": "CASINO",
				"postcode": "2470",
				"state": "NSW",
				"email": "email@gmail.com",
				"country": "AUS"
			}
		}
	]
};

// submit the KYC data to the bronID API
axios
	.post(apiEndpoint, kycData)
	.then(res => {
		// print the verification results
		console.log('click the results to expand them');
		console.log(JSON.stringify(res.data, null, 2));
	})
	.catch(error => {
		console.log('error! click the results to expand them');
		console.log(JSON.stringify(error.response.data, null, 2));
	})
	
// Click “▶ run” to try this code live and run your first KYC.