Get IDV certificate

You can obtain an IDV Certificate for each KYC and KYB that has been verified through bronID. This PDF document includes details about the verification conducted, such as the IDV reference, the IDV procedure, and the name of the verified individual or organisation. For KYBs where applicable, the IDV Certificate may also feature additional information sourced from public registers, such as the names of directors, shareholders, or public officers, along with other pertinent information obtained from independent, reliable commercial or government registries.

API call

POST

/getEntryDocument

// api endpoint
const apiEndpoint = 'https://dev.bronid.com/getEntryDocument';

// request body
const data = {
  "metadata_version": "4",
  "metadata_serviceUid": "YOUR_SERVICE_UID",
  "metadata_secretKey": "YOUR_API_KEY",

  // lookup by trace
  "trace": "0b72b60c-610c-4098-9ae5-e5aae8636bc1"

};

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

  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 result = await response.json();
    const printResult = 'bronId API response: ' + JSON.stringify(result, null, 2);
    console.log(printResult);
  }
} catch (error) {
  console.log('Fetch error: ', error);
}

API response

The response provides a digitally signed link to the IDV Certificate, which will expire at the time indicated by the expires parameter.

Sample response

{
	"fileName": "IDV_Certificate_Sample",
	"downloadUrl": "https://storage.googleapis.com/rest/of/link",
	"expires": 1622633288849
}