Test values
You can use these test values to trigger different verification outcomes when testing your integration in the test environment.
Individuals
To get a verified response for an individual, you can use the middleName parameter, or you can submit 2 verified ID documents. Any other values will result in a rejected verification.
| Outcome | Parameter | Value |
|---|---|---|
| Verified | middleName | ok |
| Verified with positive watchlist matches | middleName | pep |
Australia-specific test values
For Australian individual verifications, you can use these document numbers to get verified responses:
| Outcome | Parameter | Value |
|---|---|---|
| Verified driver licence | driverLicenceNumber | 11111111 |
| Verified passport | passportNumber | A1111111 |
| Verified medicare | medicareCardNumber | 2111111111 |
Entities
You can use the name parameter to trigger different verification results when submitting entities. The verification status change (after the initial pending response) will be sent to your registered webhook.
| Outcome | Parameter | Value |
|---|---|---|
| Verified | name | Starts with Pass |
| Verified with positive watchlist matches | name | Starts with Pass PEP |
| Info | name | Starts with Info |
| Rejected | name | Starts with Fail |
Code samples
The examples below show how to trigger each verification outcome. Replace the credentials with your own API keys.
Verified entity
Use a name starting with Pass to trigger a verified status.
Request body:
{
"userId": "test-verified-entity",
"country": "AUS",
"type": "company",
"name": "Pass My Company Pty Ltd"
}
cURL example:
curl -X POST https://dev.bronid.com/v5/verifications \
--user "your-api-key:your-api-secret" \
-H "Content-Type: application/json" \
--data '{"userId":"test-verified-entity","country":"AUS","type":"company","name":"Pass My Company Pty Ltd"}'
Info status (additional information required)
Use a name starting with Info to trigger an info status, which indicates additional information is required.
Request body:
{
"userId": "test-info-entity",
"country": "AUS",
"type": "company",
"name": "Info My Company Pty Ltd"
}
cURL example:
curl -X POST https://dev.bronid.com/v5/verifications \
--user "your-api-key:your-api-secret" \
-H "Content-Type: application/json" \
--data '{"userId":"test-info-entity","country":"AUS","type":"company","name":"Info My Company Pty Ltd"}'
Rejected entity
Use a name starting with Fail to trigger a rejected status.
Request body:
{
"userId": "test-rejected-entity",
"country": "AUS",
"type": "company",
"name": "Fail My Company Pty Ltd"
}
cURL example:
curl -X POST https://dev.bronid.com/v5/verifications \
--user "your-api-key:your-api-secret" \
-H "Content-Type: application/json" \
--data '{"userId":"test-rejected-entity","country":"AUS","type":"company","name":"Fail My Company Pty Ltd"}'
Verified individual
Use middleName: "ok" to trigger a verified status for an individual.
Request body:
{
"userId": "test-verified-individual",
"country": "AUS",
"type": "individual",
"firstName": "John",
"middleName": "ok",
"lastName": "Smith",
"dateOfBirth": "1990-01-15"
}
cURL example:
curl -X POST https://dev.bronid.com/v5/verifications \
--user "your-api-key:your-api-secret" \
-H "Content-Type: application/json" \
--data '{"userId":"test-verified-individual","country":"AUS","type":"individual","firstName":"John","middleName":"ok","lastName":"Smith","dateOfBirth":"1990-01-15"}'
What is next?
- Set up webhooks to receive verification status updates
- Learn about verification statuses and how to retrieve detailed results
- Handle errors that may occur during verification