KYC with nested stakeholders (AUS)

This page contains only params relevant for the specific example. For a complete list of params for this API call visit this page.

Nested entities

When the stakeholder of an entity is another entity (e.g. a parent company), you can nest the parent company verification details. In the example bellow, we have the target entity and two stakeholders: one individual and one private company. How you nest the company structure depends on the legal structure of the entities.

Runnable example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
// 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",
	
	// entity details
	"type": "unRegulatedTrust",
	"fields": {
		"country": "AUS",
		"name": "My Unregulated Trust",
		"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": "privateCompany",
			"role": "trustee",
			"fields": {
				"country": "AUS",
				"acn": "123456789",
				"abn": "16123456789",
				"name": "My Company",
				"registeredOffice": "125 York Street, SYDNEY NSW 2000",
				"principalPlaceOfBusiness": "250 York Street, SYDNEY NSW 2000",
				"companyExtract": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
			},
			stakeholders: [{
				"type": "individual",
				"role": "shareholders",
				"fields": {
					"firstName": "Second",
					"middleName": "ok",
					"lastName": "Citizen",
					"gender": "female",
					"dateOfBirth": "20/10/1980",
					"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.error(error)
	})
	
// Click “▶ run” to try this code live and run your first KYC.