IDV Risks
The idvRisk field indicates the calculated identity verification risk level assigned to an entity.
idvRisk vs inputRisk
inputRisk— the risk level provided by the customer when submitting the verification. This is what was sent in the API request.idvRisk— the system-calculated composite risk.
Risk levels
| Value | Description |
|---|---|
unknown | Risk has not been calculated yet. |
low | Low risk. The entity has passed all verification checks with no concerns identified. |
low_medium | Low-medium risk. The entity has minor concerns that may require attention but are not significant. |
medium | Medium risk. The entity has some concerns identified that should be reviewed. |
medium_high | Medium-high risk. The entity has notable concerns that require careful consideration. |
high | High risk. The entity has significant concerns identified during verification. |
Usage example
The idvRisk and inputRisk fields appear in verification responses and webhook payloads:
Example response
{
"userId": "user-123",
"trace": "abc123",
"name": "My Company",
"country": "AUS",
"type": "company",
"subType": "none",
"inputRisk": "low",
"idvRisk": "medium",
"verificationStatus": "verified"
}