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
streetNumber
(required)		string
streetName
(required)		string
streetType
(required)		stringStreet types
suburb
(required)		string
postcode
(required)		string
state
(required)		stringUSA state
socialSecurityNumber
string
phone
string
email
string

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": "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.log('error! click the results to expand them');
		console.log(JSON.stringify(error.response.data, null, 2));
	})
	
// Click “▶ run” to try this code live and run your first KYC.