KYC verification of 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
address
stringaddress line 1
unitNumber
(required, if present)		string or null*
streetNumber
(required)		string
streetName
(required)		string
streetType
(required, if present)		string or null*Street types
suburb
(required)		string
postcode
(required)		string
state
(required)		stringUSA state
socialSecurityNumber
string
phone
string
email
string

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.

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",
	"metadata_tags": ["product1", "client1"],
	
	"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"
	}
};

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.