KYC verification of individuals

This specification is for the verification of individuals from the CAN, DNK, ITA, SWE. Use this API call to perform KYC verification of individuals.

Parameters

NameTypeDescription
country
(required)		stringCAN, DNK, ITA, SWE
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
province
stringState / Province
nationalId
stringNational ID number
gender
stringmale/female/other/preferNotToSay
phone
string
email
string

Notes

The

nationalId
is different for each country.

CountryNational IDFormat
CANSocial Insurance Number (SIN)9 digits (123456789 or 123-456-789)
DNKCivil Registration System (CPR)10 digits (DDMMYY-0000)
ITACodice Fiscale16 characters (SSSNNNYYMDDZZZZX)
SWEPersonal Identification Number (PIN)10 digits (YYMMDD-NNGC)

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": "DNK",
		"firstName": "Jane",
		"middleName": "ok",
		"lastName": "HØEG",
		"dateOfBirth": "20/10/1980",
		"nationalId": "201090-1234",
		"address": "Asiatisk Plads 2",
		"locality": "København",
		"province": "Byen København",
		"postcode": "1448",
		"phone": "4540798403",
		"email": "email@gmail.com"
	}
};

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

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