Understanding entity profile KYC results
The results of a verification check (or a call to the endpoint GET /entity/{entityId}/checks
) when an entity has a configured profile will still return all of the structures of the existing check results. There is however, an additional section/object named entityProfileResult
. An example response would look something like the following:
Below is a brief summary of the properties contained in the entityProfileResult
entityProfileResult
Raw Result | Commentary | Type |
---|---|---|
entityProfileResult | This is the object response returned after making a call to this endpoint. | Object |
actionRecommended | This is the same actionRecommended as found in the original checkSummary . It contains the result one of:PASS PASS_MANUAL REFER FAIL FAIL_MANUAL UNCHECKED It is recommended you decide how to interpret these results. | String |
addressResults | Each address gets its own results | Object |
checkResults | For each checkType that was applied in this profile - did it PASS, FAIL or was NA (not applicable). | Array of Objects |
checkType | The list of checkTypes applied as part of this profile. | String |
documentResults | Like the addresses, we supply the results of each document that was checked. | Object |
entityId | This is the entity Identifier. It is recommended you store this value | String |
issueList | This is the comma-separated list of issues Issue codes are: 404 : No match500 : Service errorPTL : Partial match onlyPEP : PEP matchS : Sanctions matchWL : AML Watchlist matchM : Adverse Media matchFRAUD : Fraud list or check matchDUP : DuplicateBL : BlacklistATT : No IDV dataATT-IDV : ID Validation failedATT-PHT : Photo comparison failed ATT-OCR : OCR scanned document was modifiedATT-NCMP : Biometrics Not CompletedFRAUD : Fraud list matchDEVICE : There was a device-fraud related issueSUPPORT-DOCS : Supporting Documents | String |
kycResults | We break down each ID element that is used to verify an entity. | Array of Objects |
latestCheckDate | This describes when the check was last run. | String |
manualIntervention | Was manual intervention required? | Boolean |
profileName | Specify if profile name was applied. | String |
riskLevel | Final risk level. | String |
riskPolicy | Risk policy applied, based on the risk rules engine. | String |
This new format gives a more detailed and clearer picture than having to dig through the original check results and checkSummary
key/value pairs. But all of that raw data is still available if you request a full check result.
A summary result will return the checkRisk
, checkSummary
and entityProfileResult
properties.
A simple result will just return the entityProfileResult
property - although this only works for entity’s with a profile.
Example
"entityProfileResult": {
"actionRecommended": "PASS_MANUAL",
"addressResults": {
"a63d471b-9417-4474-0ee0-aa7310055e38": {
"checked": true,
"matchCount": 1,
"matchSources" : [
"au-ntd"
],
"matchType": "curr_addr",
"verified": true
}
},
"checkResults": [
{
"checkType": "two_plus",
"result": "PASS"
},
{
"checkType": "id",
"result": "PASS"
},
{
"checkType": "pep_media",
"result": "PASS"
},
{
"checkType": "idvalidate",
"code": "MISSING_PREREQUISITE",
"message": "Attestation check succeeded. The attestation documents are not present, but
are not required",
"result": "NA"
}
],
"checkType": "two_plus, id, pep_media, idvalidate",
"documentResults": {
"4a38bc35-f2de-77e0-cbbe-b3b27f644ce8": {
"checked": true,
"matchCount": 1,
"matchSources" : [
"au-govid-dl"
],
"matchType": "gov_id",
"verified": true
},
"9e658277-9bbc-11cc-1f83-593abf54ed6c": {
"checked": true
}
},
"entityId": "b90d22ab-9571-48c9-6c66-1e7924501b9b",
"kycResults": [
{
"matchCount": 3,
"matchSources" : [
"au-ntd",
"au-elec-roll",
"au-phone-pub"
],
"matchCountRequired": 2,
"matchTypes": {
"name": {
"checked": true,
"matchCount": 3,
"verified": true
}
},
"verified": true
},
{
"matchCount": 4,
"matchSources" : [
"au-ntd",
"au-elec-roll",
"au-phone-pub",
"au-asic"
],
"matchCountRequired": 2,
"matchTypes": {
"address": {
"checked": true,
"matchCount": 1,
"verified": true
},
"dob": {
"checked": true,
"matchCount": 3,
"verified": true
}
},
"verified": true
},
{
"matchCount": 1,
"matchSources" : [
"au-govid1-dl"
],
"matchCountRequired": 1,
"matchTypes": {
"gov_id": {
"checked": true,
"matchCount": 1,
"verified": true
}
},
"verified": true
}
],
"latestCheckDate": "2020-08-09T14:04:35.624Z",
"manualIntervention": true,
"profileName": "default",
"riskLevel": "MEDIUM",
"riskPolicy": "CDD"
},
}
Example with a Partial Fail
{
"entityProfileResult": {
"actionRecommended": "FAIL",
"addressResults": {
"de2854e6-25cf-74b8-13ea-2df34b07b56c": {
"checked": true,
"nonmatchSources": [
"Equifax Public Credit Data Header",
"Equifax Proprietary Phone Directory",
"Australian Electoral Roll",
"Australian National Tenancy Database",
"Australian Public Phone Directory"
]
}
},
"checkId": "28058802-2637-fbd9-c007-b4a91c5b881f",
"checkResults": [
{
"checkClass": "fraud",
"checkType": "blacklist",
"name": "Blacklist",
"result": "PASS"
},
{
"checkClass": "kyc",
"checkType": "two_plus",
"code": "PARTIAL_MATCH",
"message": "Partial Match",
"name": "2+2",
"result": "FAIL"
}
],
"checkType": "blacklist,two_plus",
"creditHeaderFailures": [
"Equifax"
],
"entityId": "2de4a393-e868-c21d-8808-8ef8807693fc",
"issueList": [
"PTL"
],
"kycResults": [
{
"matchCount": 3,
"matchCountRequired": 2,
"matchTypes": {
"name": {
"checked": true,
"matchCount": 3,
"matchSources": [
"Australian Electoral Roll",
"Equifax Proprietary Phone Directory",
"Equifax Public Credit Data Header"
],
"nonmatchSources": [
"Australian Public Phone Directory",
"Equifax Commercial Credit Data Header",
"Equifax Public Credit Data Header",
"IDMatrix"
],
"verified": true
}
},
"verified": true
},
{
"matchCountRequired": 2,
"matchTypes": {
"address": {
"checked": true,
"nonmatchSources": [
"Australian Electoral Roll",
"Australian National Tenancy Database",
"Australian Public Phone Directory",
"Equifax Proprietary Phone Directory",
"Equifax Public Credit Data Header"
]
},
"dob": {
"checked": true,
"nonmatchSources": [
"Australian Electoral Roll",
"IDMatrix"
]
}
}
}
],
"latestCheckDate": "2022-05-09T08:01:30.039Z",
"policyName": "default",
"profileName": "safe_harbour",
"riskLevel": "LOW",
"riskPolicy": "CDD"
}
}
Example with a No Match
{
"entityProfileResult": {
"actionRecommended": "FAIL",
"checkId": "a4fa419c-31ac-2595-826a-3c4d5a1deabf",
"checkResults": [
{
"checkClass": "fraud",
"checkType": "blacklist",
"name": "Blacklist",
"result": "PASS"
},
{
"checkClass": "kyc",
"checkType": "id",
"code": "NO_MATCH",
"message": "No Match",
"name": "Gov ID",
"result": "FAIL"
},
{
"checkClass": "kyc",
"checkType": "two_plus",
"code": "NO_MATCH",
"message": "No Match",
"name": "2+2",
"result": "FAIL"
},
{
"checkClass": "none",
"checkType": "idvalidate",
"code": "BLOCKED_BY_OTHER_FAIL",
"message": "Gov ID check failed, therefore not running IDV check",
"name": "IDV",
"result": "UNCHECKED"
},
{
"checkClass": "aml",
"checkType": "pep",
"code": "BLOCKED_BY_OTHER_FAIL",
"message": "Gov ID check failed, therefore not running PEP/Sanctions check",
"name": "PEP/Sanctions",
"result": "UNCHECKED"
}
],
"checkType": "blacklist,id,two_plus,idvalidate,pep",
"creditHeaderFailures": [
"Equifax"
],
"documentResults": {
"9e7c3ca2-a199-3390-1254-6d524094e711": {
"checked": true,
"nonmatchSources": [
"Australian Gov ID - Drivers Licence"
]
}
},
"entityId": "9b42d630-d5f8-8a57-1088-a84478e6f50d",
"issueList": [
"404"
],
"kycResults": [
{
"matchCountRequired": 1,
"matchTypes": {
"gov_id": {
"checked": true,
"nonmatchSources": [
"Australian Gov ID - Drivers Licence"
]
}
}
},
{
"matchCountRequired": 2,
"matchTypes": {
"name": {
"checked": true,
"nonmatchSources": [
"Equifax Commercial Credit Data Header",
"Equifax Consumer Credit Data Header",
"Equifax Public Credit Data Header",
"IDMatrix"
]
}
}
},
{
"matchCountRequired": 2,
"matchTypes": {
"address": {},
"dob": {
"checked": true,
"nonmatchSources": [
"IDMatrix"
]
}
}
}
],
"latestCheckDate": "2023-08-14T05:48:29.000Z",
"policyName": "default",
"profileName": "safe_harbour_id",
"riskLevel": "MEDIUM",
"riskPolicy": "CDD"
}
}
Updated 10 months ago