Distributor KYC API

Use this API call to perform KYC verification on behalf of your customers.

This API has the same format as the regular KYC API, but it includes one extra parameter (

) which is the UserId value of your onBehalf customer. Verifications submitted with this parameter will also be visible to your customers through their portal account.

You can additionally use the

param if you want to group the verifications.

The onBehalf and tags parameters can be used for filtering the verification and billing history.


stringthe UserId of your customer
string arraygrouping tags

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", "metadata_onBehalf": "REPLACE_WITH_YOUR_CUSTOMER_SERVICE_UID", "metadata_tags": ["tag1", "tag2"], "type": "individual", "fields": { "country": "AUS", "firstName": "Jane", "middleName": "ok", "lastName": "Citizen", "gender": "female", "dateOfBirth": "20/10/1980", "unitNumber": "1", "streetNumber": "95", "streetName": "Lennox", "streetType": "Street", "suburb": "CASINO", "postcode": "2470", "state": "NSW", "email": "email@gmail.com" } }; console.log('Running request...') // submit the KYC data to the bronID API const bronIdResult = await axios .post(apiEndpoint, kycData) .then(res => { return res.data; }) .catch(error => { console.log('error! click the results to expand them'); console.log(JSON.stringify(error.response.data, null, 2)); }) const printResult = 'bronId API response: ' + JSON.stringify(bronIdResult, null, 2); // Click “▶ run” to try this code live and run your first KYC.