KYC verification of unregulated trusts (GBR)

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

Parameters

NameTypeDescription
country
(required)		string3 letter country ISO
name
(required)		string
registeredOfficeRequired
(required)		stringaddress
trustDeed
(required)		stringbase64 Data URI (JPG/PNG/PDF)
stakeholders
(required)		arraybeneficiaries / trustee (*) / settlors

Stakeholder types

NameTypeNote
beneficiaries
individual
trustee
(required)		individual, private company, public company, government body
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": "trust",
    "fields": {
        "country": "GBR",
        "name": "entity name",
        "registeredOfficeRequired": "GBR registered office",
        "trustDeed": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
    },
    "stakeholders": [
        {
            "type": "individual",
            "role": "beneficiaries",
            "fields": {
                "country": "GBR",
                "firstName": "Jane",
                "middleName": "ok",
                "lastName": "Citizen",
                "gender": "female",
                "dateOfBirth": "20/10/1980",
                "address": "210 Pentonville Road",
                "unitNumber": "",
                "streetNumber": "210",
                "streetName": "Pentonville",
                "streetType": "Road",
                "locality": "London",
                "postcode": "N19AA",
                "phone": "2074999000",
                "email": "email@gmail.com"
            }
        },
        {
            "type": "individual",
            "role": "trustee",
            "fields": {
                "country": "GBR",
                "firstName": "Jane",
                "middleName": "ok",
                "lastName": "Citizen",
                "gender": "female",
                "dateOfBirth": "20/10/1980",
                "address": "210 Pentonville Road",
                "unitNumber": "",
                "streetNumber": "210",
                "streetName": "Pentonville",
                "streetType": "Road",
                "locality": "London",
                "postcode": "N19AA",
                "phone": "2074999000",
                "email": "email@gmail.com"
            }
        },
        {
            "type": "individual",
            "role": "settlors",
            "fields": {
                "firstName": "American",
                "middleName": "ok",
                "lastName": "Person",
                "gender": "female",
                "dateOfBirth": "30/10/1982",
                "email": "person@email.com",
                "country": "USA",
                "socialSecurityNumber": "12345",
                "address": "250 Point Lobos Ave, San Francisco CA",
                "unitNumber": "",
                "streetNumber": "250",
                "streetName": "Point Lobos",
                "streetType": "Ave",
                "suburb": "San Francisco",
                "postcode": "941211471",
                "state": "CA",
                "phone": "0432248425"
            }
        }
    ]
};

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.