Detailed Verification Report
- 07 Oct 2024
- 6 Minutes to read
- DarkLight
- PDF
Detailed Verification Report
- Updated on 07 Oct 2024
- 6 Minutes to read
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
The Detailed Verification Report API retrieves the verification results for a transaction. The following data is included in the report:
Personal information
Document information
An SFT URL to the picture of the ID document
The score and the threshold that are associated with the verification
For more information about downloading the pictures of the ID document, see Download image binary data.
Syntax
GET /api/transactions/id/detailed-verification-reportAvailable parameters
Request parameters | ||
Name | Type | Description |
|---|---|---|
id | String | Required. This is the unique identifier of the verification of a single person. |
Examples
Example request
curl --location --request GET 'http(s)://$host:$port/api/transactions/$TX_ID/detailed-verification-report' \
--header 'Authorization: Bearer $TENANT_ACCESS_TOKEN'Example responses
The Detailed Verification Report response contains information about the various stages of a transaction. The actual content of the response depends on the IDV status of the transaction.
CreateVerification stage response
In this stage, the response covers all data that was submitted prior to the start of the verification process.
{
"id": "fe74D66E-6B51-8992-A169-E14C3c281E5f",
"result": "Undefined",
"status": "InProgress",
"stages": [
{
"stageId": 1,
"stageType": {
"title": "CreateVerification"
},
"attemptNumber": 1,
"result": "Passed",
"created": "2021-09-29T18:25:43.511Z",
"details": {
"personalInformation": {
"nameInformation": {
"forename": "John",
"surname": "Doe",
"birthSurname": "B"
},
"dateOfBirth": "1999-01-01",
"addressInformation": {
"flatOrApartmentNumber": 123,
"houseName": "MyHouse",
"houseNumber": 456,
"postCode": "MyPostCode",
"country": "MyCountry",
"countyOrProvince": "MyProvince",
"poBox": 1234,
"street": "MyStreet",
"town": "MyTown",
"city": "MyCity"
},
"mobilePhoneNumber": "+12345678900"
}
}
}
]
}AddProviderData stage response
In this stage, the response covers all data that was extracted from the provided IDs.
{
"stageId": 1,
"stageType": {
"service": "DocumentId",
"provider": "xyz",
"title": "AddProviderData"
},
"comment": "Identity Verification Data is successfully extracted from provider.",
"attemptNumber": 1,
"result": "Passed",
"created": "2023-03-22T12:37:35.065Z",
"details": {
"personalInformation": {
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/Test_Tenant_ID/transactions/bf0d536d-3cb9-41b5-b158-8a5936169XXX/document/a5658e14-d174-47f6-8ab2-14da8257cXXX/jpeg"
}
]
},
"extractedDocumentSegments": [
{
"zone": "MergedZones",
"personalInformation": {
"nameInformation": {
"forename": "JOHN",
"surname": "DOE"
},
"dateOfBirth": "1980-01-01",
"gender": "Male",
"nationality": "GBR",
"addressInformation": {},
"documentElement": {
"type": "Passport",
"number": "123456789",
"issuingCountry": "GB",
"issuingAuthority": "HMPO",
"issueDate": "2018-08-09",
"expiryDate": "2029-05-09"
}
},
"providerSpecificData": {
"Document Class Name": "Passport",
"Issuing State Name": "United Kingdom (Citizen)",
"Issuing State Code": "GBR",
"Issue Date": "/Date(1533772800000)/",
"Document Class Code": "P",
"Biographic.ExpirationDate": "/Date(1872979200000)/",
"Nationality Name": "United Kingdom (Citizen)"
}
},
{
"zone": "Viz",
"personalInformation": {
"nameInformation": {
"forename": "JOHN",
"surname": "DOE"
},
"dateOfBirth": "1980-01-01",
"gender": "Male",
"addressInformation": {},
"documentElement": {
"number": "123456789",
"issuingAuthority": "HMPO",
"issueDate": "2018-08-09",
"expiryDate": "2029-05-09"
}
},
"providerSpecificData": {
"VIZ Nationality Name": "BRITISH CITIZEN",
"VIZ Issue Date": "/Date(1533772800000)/",
"VIZ Expiration Date": "/Date(1872979200000)/"
}
},
{
"zone": "Mrz",
"personalInformation": {
"nameInformation": {
"forename": "JOHN",
"surname": "DOE"
},
"dateOfBirth": "1980-01-01",
"gender": "Male",
"nationality": "GBR",
"addressInformation": {},
"documentElement": {
"number": "123456789",
"issuingCountry": "GB",
"expiryDate": "2029-05-09"
}
},
"providerSpecificData": {
"VI Issuing State Code": "GBR",
"VI Document Class Code": "P",
"VI Issuing State Name": "United Kingdom (Citizen)",
"VI Nationality Name": "United Kingdom (Citizen)",
"VI Expiration Date": "/Date(1872979200000)/"
}
},
{
"zone": "MergedZones",
"segmentCategory": "Type",
"personalInformation": {
"documentElement": {
"type": "Passport",
"issuingCountry": "GB"
}
},
"providerSpecificData": {
"Type.IssuerName": "United Kingdom (Citizen)",
"Type.IssueType": "ePassport",
"Type.CountryCode": "GBR",
"Type.IssuerCode": "GBR",
"Type.ClassName": "Passport",
"Type.ClassCode": "P"
}
},
{
"zone": "MergedZones",
"segmentCategory": "Front",
"personalInformation": {
"documentElement": {
"type": "Passport",
"issuingCountry": "GB"
}
},
"providerSpecificData": {
"Front.ClassCode": "P",
"Front.IssuerName": "United Kingdom (Citizen)",
"Front.ClassName": "Passport",
"Front.IssuerCode": "GBR",
"Front.IssueType": "ePassport",
"Front.CountryCode": "GBR"
}
}
]
}
]
}
}
}
AttemptVerification Stage response
In this stage, the response covers the verification result for a given field.
{
"stageId": 3,
"stageType": {
"service": "DocumentId",
"provider": "xyz",
"title": "AttemptVerification"
},
"attemptNumber": 1,
"result": "Passed",
"created": "2023-05-23T10:59:16.088Z",
"details": {
"matchers": [
{
"name": "document_number",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "document_number",
"description": "Compares document number submitted and extracted.",
"evaluated": "[1234567M123PB5, KB1234567]",
"operator": "Equivalent",
"evaluatedAgainst": "1234567M123PB5",
"result": "Passed",
"personalInformation": {
"documentsInformation": [
{
"documentElement": {
"number": "1234567M123PB5",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/ONESPAN_IDV_LIVE/transactions/439dfba9-817a-433d-83c3-8c384a43f5de/document/d11196a9-31af-4b94-a154-2695c7d46a00/jpeg"
}
]
},
"extractedDocumentSegments": [
{
"zone": "MergedZones",
"personalInformation": {
"documentElement": {
"number": "KB1234567",
"identificationNumber": "1234567M123PB5"
}
}
}
]
}
]
}
}
]
},
{
"name": "date_of_birth",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "date_of_birth",
"description": "Compares date of birth submitted and extracted.",
"evaluated": "1986-10-16",
"operator": "EqualsTo",
"evaluatedAgainst": "1986-10-16",
"result": "Passed",
"personalInformation": {
"dateOfBirth": "1986-10-16",
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/ONESPAN_IDV_LIVE/transactions/439dfba9-817a-433d-83c3-8c384a43f5de/document/d11196a9-31af-4b94-a154-2695c7d46a00/jpeg"
}
]
},
"extractedDocumentSegments": [
{
"zone": "MergedZones",
"personalInformation": {
"dateOfBirth": "1986-10-16"
}
}
]
}
]
}
}
]
},
{
"name": "date_of_expiry",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "date_of_expiry",
"description": "Checks that document expire date is today or later.",
"evaluated": "2023-12-15",
"operator": "GreaterOrEqualsTo",
"evaluatedAgainst": "2023-05-23",
"result": "Passed",
"personalInformation": {
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/ONESPAN_IDV_LIVE/transactions/439dfba9-817a-433d-83c3-8c384a43f5de/document/d11196a9-31af-4b94-a154-2695c7d46a00/jpeg"
}
]
},
"extractedDocumentSegments": [
{
"zone": "MergedZones",
"personalInformation": {
"documentElement": {
"expiryDate": "2023-12-15"
}
}
}
]
}
]
}
}
]
},
{
"name": "document_supported",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "document_supported",
"description": "Compares a match of countries and supported document types.",
"evaluated": "{\"type\":\"P\",\"country\":\"GB\"}",
"operator": "Equivalent",
"evaluatedAgainst": "{\"type\":\"P\",\"country\":\"GB\"}",
"result": "Passed",
"personalInformation": {
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"issuingCountry": "GB",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/ONESPAN_IDV_LIVE/transactions/439dfba9-817a-433d-83c3-8c384a43f5de/document/d11196a9-31af-4b94-a154-2695c7d46a00/jpeg"
}
]
},
"extractedDocumentSegments": [
{
"zone": "MergedZones",
"personalInformation": {
"documentElement": {
"type": "Passport",
"issuingCountry": "GB"
}
},
"providerSpecificData": {
"documentType": "XX_Passport_YYYY",
"DD_ExpeditionPlace_Out": "GBR",
"DD_IssuingCountry_Out": "GBR"
}
}
]
}
]
}
}
]
},
{
"name": "address_match",
"comment": "Some data was not supplied, the comparison cannot be executed.",
"result": "Error",
"behaviors": [
"ExecuteOnly"
],
"checks": [
{
"name": "address_match",
"description": "Compares address submitted and extracted.",
"operator": "Equivalent",
"evaluatedAgainst": "{\"houseNumber\":\"11\",\"postCode\":\"ABC123\",\"poBox\":\"1234\"}",
"result": "AnalysedDataInsufficient",
"personalInformation": {
"addressInformation": {
"houseNumber": "11",
"postCode": "ABC123",
"poBox": "1234"
},
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/ONESPAN_IDV_LIVE/transactions/439dfba9-817a-433d-83c3-8c384a43f5de/document/d11196a9-31af-4b94-a154-2695c7d46a00/jpeg"
}
]
}
}
]
}
}
]
},
{
"name": "name",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "name",
"description": "Full name match: compares different name part submitted and extracted in order to determine how closely the submitted and extracted data is. Matching the calculated proximity is between 0.0 and 1.0 which is to be understood as a percentage of similarity.",
"evaluated": "1.0",
"operator": "GreaterOrEqualsTo",
"evaluatedAgainst": "1.0",
"result": "Passed",
"personalInformation": {
"nameInformation": {
"forename": "John",
"surname": "Doe"
},
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/ONESPAN_IDV_LIVE/transactions/439dfba9-817a-433d-83c3-8c384a43f5de/document/d11196a9-31af-4b94-a154-2695c7d46a00/jpeg"
}
]
},
"extractedDocumentSegments": [
{
"zone": "MergedZones",
"personalInformation": {
"nameInformation": {
"forename": "JOHN",
"surname": "DOE"
}
}
}
]
}
]
}
}
]
},
{
"name": "face_similarity",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "face_similarity",
"description": "Determine how closely selfie(s) is(are) similar to picture of the person on the document.",
"evaluated": "0.9999998366743112",
"operator": "GreaterOrEqualsTo",
"evaluatedAgainst": "0.7",
"result": "Passed",
"personalInformation": {
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/DTE_AGREEMENT_AUTOMATION_TEST/transactions/yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy/document/a0564f56-be41-4d94-ad3f-8069c132bec0/jpeg"
}
]
},
"analyzedData": [
{
"result": "0.9999998366743112",
"biometricInformation": {
"type": "Picture",
"detail": "Selfie",
"url": "sfs://MyURL/default/DTE_AGREEMENT_AUTOMATION_TEST/transactions/yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy/biometrics/23268a24-1d1f-420e-b33c-878bb313eef6/jpeg"
}
}
]
}
]
}
}
]
},
{
"name": "liveness_check",
"result": "Match",
"behaviors": [
"AffectsVerificationAttemptResult"
],
"checks": [
{
"name": "liveness_check",
"description": "Checks the liveness of the selfie(s).",
"evaluated": "1.0",
"operator": "GreaterOrEqualsTo",
"evaluatedAgainst": "0.95",
"result": "Passed",
"personalInformation": {
"documentsInformation": [
{
"documentElement": {
"type": "Passport",
"pages": [
{
"type": "PassportDataPage",
"url": "sfs://MyURL/default/DTE_AGREEMENT_AUTOMATION_TEST/transactions/yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy/document/a0564f56-be41-4d94-ad3f-8069c132bec0/jpeg"
}
]
},
"analyzedData": [
{
"result": "1.0",
"biometricInformation": {
"type": "Picture",
"detail": "Selfie",
"url": "sfs://MyURL/default/DTE_AGREEMENT_AUTOMATION_TEST/transactions/yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy/biometrics/23268a24-1d1f-420e-b33c-878bb313eef6/jpeg"
}
}
]
}
]
}
}
]
}
]
}
}
]
}
Status codes
Status code | Name | Description |
|---|---|---|
200 | OK | Verification report is successfully retrieved. |
400 | Bad Request | The client has provided invalid input. |
401 | Unauthorized | The client has not provided a valid access token, or has provided an access token which misses a number of claims. In this specific case, for reasons of security, no details are provided in the response. |
404 | Not Found | The requested resource was not found. |
500 | Internal Server Error | The server encountered an unexpected condition which prevented it from completing the request. |
Was this article helpful?