KYC verification for partnerships (USA)

Use this API call to perform KYC verification of partnerships.

Parameters

NameTypeDescription
country (required)string3 letter country ISO
name (required)string
entityNumber (required)string
partnershipType (required)stringGeneralPartnership / LP / QTIP / LLP
registeredOfficeRequired (required)stringaddress
principalPlaceOfBusinessRequired (required)stringaddress
partnershipAgreement (required)stringbase64 document (JPG/PNG/PDF)
stakeholders (required)arraypartners (*)

Partnership types

NameTypeNote
GeneralPartnershipGeneral Partnership
LPLimited Partnership (LP)
QTIPQualified Terminable Interest Property (QTIP)
LLPLimited Liability Partnership (LLP)

Stakeholder types

NameTypeNote
partnersindividual

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
// 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": "partnership",
	"fields": {
		"country": "USA",
		"name": "entity name",
		"entityNumber": "123456",
		"partnershipType": "GeneralPartnership",
		"registeredOfficeRequired": "Registered office USA",
		"principalPlaceOfBusinessRequired": "Principal office USA",
		"partnershipAgreement": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
	},
	"stakeholders": [
		{
			"type": "individual",
			"role": "partners",
			"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.