KYC verification for unregulated trusts (NZL)

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

Parameters

Name	Type	Description
`country` (required)	string	3 letter country ISO
`name` (required)	string
`unRegulatedTrustType` (required)	string	familyTrust / parallelTrust / singleTrust / nextGenTrust / businessTrust / charitableTrust
`registeredOfficeRequired` (required)	string	address
`trustDeed` (required)	string	base64 document (JPG/PNG/PDF)
`stakeholders` (required)	array	beneficiaries / trustee (*) / settlors

unRegulatedTrustType options

Option	Description
`familyTrust`	Family Trust
`parallelTrust`	Parallel Trust
`singleTrust`	Single Trust
`nextGenTrust`	NextGen Trust
`businessTrust`	Business Trust
`charitableTrust`	Charitable Trust

Stakeholder types

Name	Type	Note
`beneficiaries`	individual
`trustee` (required)	individual, private company, public company, government body
`settlors`	individual

Runnable example

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

// request body
const kycData = {
	// authorization
	"metadata_version": "4",
	"metadata_serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
	"metadata_secretKey": "dev_secret_key",
	"metadata_userId": "yourUniqueUserId",
	
	// entity details
	"type": "unRegulatedTrust",
	"fields": {
		"country": "NZL",
		"name": "My Unregulated Trust",
		"unRegulatedTrustType": "familyTrust",
		"registeredOfficeRequired": "1/20 Karamu Street, Taupo 3330",
		"trustDeed": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
	},
	"stakeholders": [
		{
			"type": "individual",
			"role": "beneficiaries",
			"fields": {
				"firstName": "Jane",
				"middleName": "ok",
				"lastName": "Citizen",
				"gender": "female",
				"dateOfBirth": "12/12/1982",
				"unitNumber": "1",
				"streetNumber": "20",
				"streetName": "Karamu",
				"streetType": "Street",
				"suburb": "Taupo",
				"postcode": "3330",
				"email": "email@gmail.com",
				"country": "NZL"
			}
		},
		{
			"type": "individual",
			"role": "trustee",
			"fields": {
				"firstName": "Dave",
				"middleName": "ok",
				"lastName": "Citizen",
				"gender": "male",
				"dateOfBirth": "12/12/1982",
				"unitNumber": "1",
				"streetNumber": "20",
				"streetName": "Karamu",
				"streetType": "Street",
				"suburb": "Taupo",
				"postcode": "3330",
				"email": "email@gmail.com",
				"country": "NZL"
			}
		}
	]
};

// 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.error(error)
	})
	
// Click “▶ run” to try this code live and run your first KYC.