KYC verification of individuals

This specification is for the verification of individuals from the BRA, ESP, MEX. Use this API call to perform KYC verification of individuals.

Parameters

NameTypeDescription
country
(required)		stringBRA, ESP, MEX
firstName
(required)		string - letters, apostrophes, spaces, hyphensLess than 80 characters
middleName
(required, if present)		string - letters, apostrophes, spaces, hyphensLess than 80 characters
lastName
(required)		string - letters, apostrophes, spaces, hyphensLess than 80 characters
dateOfBirth
(required)		stringDD/MM/YYYY
address
(required)		stringAddress line 1
locality
(required)		stringCity / Locality
postcode
(required)		string
nationalId
stringNational ID number
gender
stringmale/female/other/preferNotToSay
phone
string
email
string

Notes

The

nationalId
is different for each country.

CountryNational IDFormat
BRANatural Persons Register (CPF)11 digits (12345678909)
ESPNational ID (DNI)9 characters
MEXPersonal ID Code Number (CURP)18 characters (HEGG560427MVZRRL05)

Runnable example

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": "ESP",
		"firstName": "Jane",
		"middleName": "ok",
		"lastName": "Citizen",
		"dateOfBirth": "20/10/1980",
		"nationalId": "123456789",
		"address": "Carrer del Doctor Giné i Partagàs",
		"locality": "Barcelona",
		"postcode": "08001",
		"phone": "919932015",
		"email": "email@gmail.com"
	}
};

console.log('Running request. Please wait...')

// submit the KYC data to the bronID API
try {
	const response = await fetch(apiEndpoint, {
		method: 'POST',
		headers: {
			'Content-Type': 'application/json',
		},
		body: JSON.stringify(kycData),
	});

	if (!response.ok) {
		const errorData = await response.json();
		console.log('error! click the results to expand them');
		console.log(JSON.stringify(errorData, null, 2));
	} else {
		const bronIdResult = await response.json();
		const printResult = 'bronId API response: ' + JSON.stringify(bronIdResult, null, 2);
		console.log(printResult);
	}
} catch (error) {
	console.log('Fetch error: ', error);
}

	
// Click “▶ run” to try this code live and run your first KYC.