This page contains only params relevant for the specific example. For a complete list of params for
this API call visit this page.
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.
// 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",
"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"
}
}]
}
]
};
console.log('Running request...')
// submit the KYC data to the bronID API
const bronIdResult = await axios
.post(apiEndpoint, kycData)
.then(res => {
return res.data;
})
.catch(error => {
console.log('error! click the results to expand them');
console.log(JSON.stringify(error.response.data, null, 2));
})
const printResult = 'bronId API response: ' + JSON.stringify(bronIdResult, null, 2);
// Click “▶ run” to try this code live and run your first KYC.