KYC forms for unregulated trusts (AUS)
Use this API call to generate KYC forms for unregulated trusts.
Parameters
| Name | Type | Description |
|---|---|---|
country (required) | string | 3 letter country ISO |
type (required) | string | "unRegulatedTrust" |
name | string | |
abn | string | 11 digits |
registeredOffice | string | address |
unRegulatedTrustType | string | familyTrust / charitableTrust / testamentaryTrust / unitTrust / otherType |
uploadTrustDeed | string | base64 Data URI (JPG/PNG/PDF) |
stakeholders | array | beneficiaries / trustee / settlors |
unRegulatedTrustType options
| Option | Description |
|---|---|
familyTrust | Family Trust |
charitableTrust | Charitable Trust |
testamentaryTrust | Testamentary Trust |
unitTrust | Unit Trust |
otherType | Other Type |
Stakeholder types
| Name | Type | Note |
|---|---|---|
beneficiaries | individual | Individuals who directly or indirectly own 25% or more of the entity, or are entitled to 25% or more of the income or assets of the entity. |
trustee (required) | individual, private company, public company, government body | |
settlors | individual |
Response format
{
"source": "bronid",
"bronLink": "https://preview.bronid.com/idForm/5ae132d1-a4f6-4e72-adf4-92aa4faa39a3",
"verificationUuid": "5ae132d1-a4f6-4e72-adf4-92aa4faa39a3",
"status": "success"
}
Restrictions
- URL is accessible for a 31 days after generation (reduced prefilled data after 30 minutes)
- URL can be opened maximum 10 times without being saved
- URL can be used for a maximum of 5 verification attempts
Tags
You can add tags to your verification requests to help you organise your verifications by using the metadata_tags parameter. Read more about tags here.
Note on uploading documents: base64 encoded uploads must be submitted as a Data URI (with data format prefix). Example PDF format:
data:application/pdf;base64,JVBERi0xLjUKJYCBgoMKMSAwIG9i...
Runnable example
POST
/idform// api endpoint
const apiEndpoint = 'https://dev.bronid.com/idform';
// request body
const data = {
"metadata_serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
"metadata_secretKey": "api_sec_NJAtNcRtUrPlf7xYDrMNP9URI-ZfN314",
"metadata_version": "4",
"metadata_userId": "yourUniqueUserId",
"bronLink_dataAccessType": "idForm",
"type": "unRegulatedTrust",
"fields": {
"country": "AUS",
"name": "Pass My Trust",
"unRegulatedTrustType": "unitTrust",
"abn": "16123456789",
"registeredOffice": "125 York Street, SYDNEY NSW 2000",
"uploadTrustDeed": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
},
"stakeholders": [
{
"type": "individual",
"role": "beneficiaries",
"fields": {
"country": "AUS",
"firstName": "Jane",
"middleName": "ok",
"lastName": "Citizen",
"gender": "female",
"dateOfBirth": "11/10/1980",
"address": "125 York st",
"email": "email@gmail.com",
"medicareCardColour": "green",
"medicareCardNumber": "2428778132",
"medicareIndividualReferenceNumber": "1",
"medicareNameOnCard": "Jane Citizen",
"medicareExpiryDate": "12/2030",
"medicareImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
}
},
{
"type": "individual",
"role": "settlors",
"fields": {
"country": "AUS",
"firstName": "Dave",
"middleName": "ok",
"lastName": "Citizen",
"gender": "male",
"dateOfBirth": "20/10/1980",
"address": "125 Pitt st",
"email": "email@gmail.com",
"driversLicenceNumber": "11111111",
"driversLicenceCardNumber": "1234567890",
"driversLicenceState": "NSW",
"driversLicenceImageFront": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"driversLicenceImageBack": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"passportNumber": "A1111111",
"passportCountryOfIssue": "AUS",
"passportImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
}
},
{
"type": "privateCompany",
"role": "trustee",
"fields": {
"country": "AUS",
"abn": "16123456789",
"acn": "123456789",
"name": "Pass my stakeholder",
"registeredOffice": "125 York Street, SYDNEY NSW 2000",
"principalPlaceOfBusiness": "250 York Street, SYDNEY NSW 2000",
"companyExtract": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
}
}
]
};
try {
const response = await fetch(apiEndpoint, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(data),
});
if (!response.ok) {
const errorData = await response.json();
console.log('error! click the results to expand them');
console.log(JSON.stringify(errorData, null, 2));
} else {
const result = await response.json();
const printResult = 'bronId API response: ' + JSON.stringify(result, null, 2);
console.log(printResult);
}
} catch (error) {
console.log('Fetch error: ', error);
}