KYC verification for public companies (AUS)

This page contains only params relevant for the specific example. For a complete list of params for this API call visit this page.

API response vs Webhook response

Processing of the entity verifications is asynchronous. This means that when you submit an entity through the API, in most cases you will receive a default "pending" response to the call itself. When the verification status changes (e.g. to "verified"), you will receive a verification status update webhook. The final verification response time can range from a few seconds up to 48 hours depending on 3rd party register access and availability.

Note: Aside from the API response, you will also receive a "pending" webhook at the moment you submit the entity. Because of this behaviour, in most cases you can use the API response as an "error/validation indicator", ignore the non-error API responses and rely on the webhooks for status updates.

Test values

In the test environment, you can trigger (fake) a successful verification if the name of the entity you are trying to verify starts with "Pass". You can find all test values here.

Runnable example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// api endpoint
const apiEndpoint = 'https://dev.bronid.com/verify';

// request body
const kycData = {
	// authorization
	"metadata_version": "4",
	"metadata_serviceUid": "XL7ULiU6B4QE9Y2iWFZnhtMDKFN2",
	"metadata_secretKey": "dev_secret_key",
	
	// entity details
	"type": "publicCompany",
	"fields": {
		"country": "AUS",
		"acn": "123456789",
		"abn": "16123456789",
		"name": "Pass My Public Company",
		"exchangeListedOn": "domesticExchange",
		"ticker": "MPC"
	}
};

// 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.error(error)
	})
	
// Click “▶ run” to try this code live and run your first KYC.