KYC verification for unregulated trusts (USA)

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

Parameters

NameTypeDescription
country (required)string3 letter country ISO
name (required)string
entityNumber (required)string
trustType (required)stringRevocable / Irrevocable / QTIP / SpecialNeedsTrust / BlindTrust / TestamentaryTrust
registeredOfficeRequired (required)stringaddress
trustDeed (required)stringbase64 document (JPG/PNG/PDF)
stakeholders (required)arraybeneficiaries / trustee (*) / settlors

trustType options

OptionDescription
RevocableRevocable
IrrevocableIrrevocable
QTIPQualified Terminable Interest Property (QTIP)
SpecialNeedsTrustSpecial Needs Trust
BlindTrustBlind Trust
TestamentaryTrustTestamentary Trust

Stakeholder types

NameTypeNote
beneficiariesindividual
trustee (required)individual, private company, public company, government body
settlorsindividual

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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
// 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": "usaTrust",
    "fields": {
        "country": "USA",
        "name": "entity name",
        "entityNumber": "123456",
        "trustType": "Irrevocable",
        "registeredOfficeRequired": "Registered office USA",
        "trustDeed": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
    },
    "stakeholders": [
        {
            "type": "individual",
            "role": "beneficiaries",
            "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"
            }
        },
        {
            "type": "individual",
            "role": "trustee",
            "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"
            }
        },
        {
            "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"
            }
        }
    ]
};

// 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.