KYC verification for individuals (USA)

Use this API call to perform KYC verification of individuals.

Parameters

NameTypeDescription
country (required)string3 letter country ISO
firstName (required)string - letters only
middleName (required, if present)string - letters only
lastName (required)string - letters only
gender (required)stringmale/female
dateOfBirth (required)stringDD/MM/YYYY
addressstringaddress line 1
unitNumber (required, if present)string
streetNumber (required)string
streetName (required)string
streetType (required)stringStreet types
suburb (required)string
postcode (required)string
state (required)stringUSA state
socialSecurityNumberstring
phonestring
emailstring

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
// 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",
	
	// individual details
	"type": "individual",
	"fields": {
		"country": "USA",
		"firstName": "Jane",
		"middleName": "ok",
		"lastName": "Citizen",
		"gender": "female",
		"dateOfBirth": "20/10/1980",
		"address": "250 Point Lobos Ave",
		"unitNumber": "",
		"streetNumber": "250",
		"streetName": "Point Lobos",
		"streetType": "Ave",
		"suburb": "San Francisco",
		"postcode": "941211471",
		"state": "CA",
		"socialSecurityNumber": "123456789",
		"phone": "0432248425",
		"email": "email@gmail.com"
	}
};

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