Authentication Response
{
"requestId": "28014b19-6de7-42b4-ab2a-6aff10366062",
"document": {
"cardRevisionDate": "string",
"endorsementsCode": "string",
"hazmatExpirationDate": "string",
"iin": "string",
"race": "string",
"restrictionCode": "string",
"personalNumber": "string",
"ssn": "string",
"suffix": "string",
"abbr3Country": "string",
"abbrCountry": "string",
"address": "string",
"city": "string",
"class": "string",
"country": "string",
"dob": "string",
"expires": "string",
"eyes": "string",
"familyName": "string",
"firstName": "string",
"fullName": "string",
"gender": "string",
"hair": "string",
"height": "string",
"id": "string",
"idType": "string",
"issued": "string",
"issuedBy": "string",
"maidenName": "string",
"middleName": "string",
"placeOfBirth": "string",
"postalBox": "string",
"state": "string",
"weight": "string",
"zip": "string"
},
"documentConfidenceScores": {
"cardRevisionDate": -1,
"endorsementsCode": -1,
"hazmatExpirationDate": -1,
"iin": -1,
"race": -1,
"restrictionCode": -1,
"personalNumber": -1,
"ssn": -1,
"suffix": -1,
"abbr3Country": 100,
"abbrCountry": 100,
"address": 100,
"city": 100,
"class": 100,
"country": 100,
"dob": 100,
"expires": 100,
"eyes": 100,
"familyName": 100,
"firstName": 100,
"fullName": 100,
"gender": 100,
"hair": 100,
"height": 100,
"id": 100,
"idType": 100,
"issued": 100,
"issuedBy": 100,
"maidenName": -1,
"middleName": 100,
"placeOfBirth": -1,
"postalBox": 100,
"state": 100,
"template": 100,
"weight": 100,
"zip": 100
},
"documentVerificationResult": {
"isDocumentExpired": false,
"isOcrSuccess": true,
"isPdf417Success": true,
"isMrzSuccess": null,
"isShuftiSuccess": null,
"isDriversLicenseRealID": false,
"isCommercialDriversLicense": null,
"isDriveOnly": null,
"isVeteran": null,
"isDonor": false,
"isLimitedDurationDocument": null,
"isInvalidated": null,
"documentConfidence": 82
},
"faceMatchVerificationResult": {
"falseAcceptanceRate": 0.0,
"faceMatchConfidence": 100,
"isSuspiciousPhoto": null
},
"antiSpoofingVerificationResult": {
"antiSpoofingFaceImageConfidence": 100,
"isDataFieldsTampered": null,
"isPhotoFromDocumentTampered": false
},
"externalVerificationResults": [],
"authenticationResults": [
{
"name": "Barcode Security",
"description": "This combined test checks the format of all data fields in the documents barcode",
"response": null,
"score": 100
},
{
"name": "Blur and Sharpness Detection",
"description": "This test checks the sharpness of the scanned images of the document",
"response": null,
"score": 100
},
{
"name": "Cropped Document Detection",
"description": "",
"response": null,
"score": 100
},
{
"name": "Proportions Check",
"description": "This test checks the aspect ratio and resolution of the scanned images",
"response": "",
"score": 100
},
{
"name": "Flash Light Detection",
"description": "This test detects flashes of light on the image which may spoil the authentication",
"response": null,
"score": 100
},
{
"name": "Stickers",
"description": "A sticker, duct tape, leftover marks from duct tape or poor UV scan quality is detected",
"response": null,
"score": 100
},
{
"name": "Digital Editing Front",
"description": "This test checks the front of the document for digital editing",
"response": null,
"score": 100
},
{
"name": "Reprint Front",
"description": "This test checks if the front side of the document was reprinted",
"response": null,
"score": 99
},
{
"name": "Front From a Screen",
"description": "This test checks the front of the document for capturing photo from the LCD screen",
"response": null,
"score": 100
},
{
"name": "Face Tampering",
"description": "This test checks the face on the document for forgery",
"response": null,
"score": 100
},
{
"name": "Barcode Authenticity",
"description": "This test verifies the authenticity of the 2D barcode",
"response": null,
"score": 100
},
{
"name": "Digital Editing Back",
"description": "This test checks the back of the document for digital editing",
"response": null,
"score": 99
},
{
"name": "Reprint Back",
"description": "This test checks if the back side of the document was reprinted",
"response": null,
"score": 100
},
{
"name": "Back From a Screen",
"description": "This test checks the back of the document for capturing photo from the LCD screen",
"response": null,
"score": 100
},
{
"name": "Series Template Match",
"description": "This test compares the series template data from the barcode with the appearance of the document",
"response": "Recognized Document type - Driver License",
"score": 100
},
{
"name": "Cross Match",
"description": "Matches the data from a barcode or MRZ with the data printed on the document",
"response": null,
"score": 100
},
{
"name": "Barcode Size",
"description": "This test checks the size of the barcode",
"response": null,
"score": 100
},
{
"name": "Barcode Readability",
"description": "This test checks the readability of the barcode",
"response": null,
"score": 100
},
{
"name": "UV Front Analysis",
"description": "This test checks that the UV marks are properly shaped and placed in the expected position on the front of the document",
"response": null,
"score": 100
},
{
"name": "UV Back Analysis",
"description": "This test checks that the UV marks are properly shaped and placed in the expected position on the back of the document. Please note that stickers on the document may cause this test to fail, so you should check the expected UV marks against those in your reference guide",
"response": "No UV Back Analysis template",
"score": 0
},
{
"name": "UV Mark Presence Front",
"description": "This test verifies the presence of the UV mark on the front of the document",
"response": null,
"score": 100
},
{
"name": "UV Mark Presence Back",
"description": "This test verifies the presence of the UV mark on the back of the document",
"response": null,
"score": 100
},
{
"name": "IR Front Analysis",
"description": "This test checks the presence of the IR mark on the front of the document",
"response": "IR mark matches to the template",
"score": 100
},
{
"name": "IR Back Analysis",
"description": "This test checks the presence of the IR mark on the back of the document",
"response": "IR mark matches to the template",
"score": 100
},
{
"name": "IR Face Check",
"description": "This test verifies the presence of the face on the IR image of the document",
"response": "IR mark was not expected",
"score": 0
},
{
"name": "IR Barcode Check",
"description": "This test verifies the presence of the barcode on the IR image of the document",
"response": null,
"score": 100
},
{
"name": "Void Mark Detection",
"description": "This test checks if the document has been invalidated",
"response": null,
"score": 100
},
{
"name": "Address Verification",
"description": "This test verifies that the address listed on the documents exists",
"response": "https://www.google.com/maps/?q=1500 123 TEST STREET",
"score": 0
},
{
"name": "ID Photo",
"description": "This test checks if the photo is acceptable according to ISO/IEC 19794-5 standard",
"response": null,
"score": 100
}
],
"requestData": null,
"images": null,
"reference": "6030F8EA357814C61D7BD9AC1A4EDD7CDF73CCDE"
}
Response Attributes:
requestId (uuid) - Request identifier
document (object) - Contains all the fields of the document which have been successfully read from the Barcode (PDF417) or the MRZ. Additionally the fields which have been recognized from the front of the document via the OCR processing that are only present on the front. When a field exists on the front and in the Barcode the data from the Barcode is a given precedence because the Barcode is a more reliable data source
documentConfidenceScores (object) - Contains all field level scores from the document.
documentVerificationResult (object) � All the test results related to the document will be returned as fields on this object
- documentVerificationResult.isDocumentExpired (boolean) this value represents if the document has expired
- documentVerificationResult.isOcrSuccess (boolean) this value represents if the document was able to have an OCR read performed successfully on the front image
- documentVerificationResult.isPdf417Success (boolean) this value represents if the document was able to have the barcode data read successfully from the back image
- documentVerificationResult.isMrzSuccess (boolean) this value represents whether a document with an MRZ was able to have that data successfully read
- documentVerificationResult.isShuftiSuccess (boolean) this value represents whether the submitted international document was processed by our partner
- documentVerificationResult.isDriversLicenseRealID (boolean) this value represents if the submitted driver's license was a REAL ID
- documentVerificationResult.isDriveOnly (boolean) this value represents if the submitted driver's license is a drive only license.
- documentVerificationResult.isVeteran (boolean) this value will indicate if the document's barcode indicates the owner is a veteran
- documentVerificationResult.isDonor (boolean) this value will indicate if the document's barcode indicates the owner is an organ donor
- documentVerificationResult.isLimitedDurationDocument (boolean) this value represents if the document is a limited duration document.
- documentVerificationResult.isInvalidated (boolean) this value represents if the document has been invalidated (for example a hole punch through the document))
- documentVerificationResult.documentConfidence (int) this value represents how well the document passed our verification process. It is between 0 and 100 (inclusive) and we recommend using 70 as your threshold
- faceMatchVerificationResult (object) � All the test results related to the matching the cropped face from the front image of the document and the selfie
- faceMatchVerificationResult.falseAcceptanceRate (float) this value is the probability that a match (a faceMatchVerificationResult.faceMatchConfidence score above a 70) is false match. We recommend that you check that his value is less than one ten thousandth.
- faceMatchVerificationResult.faceMatchConfidence (int) this value represents how well the face from the front image of the document and the selfie matched. It is between 0 and 100 (inclusive) and we recommend using 70 as your threshold
- faceMatchVerificationResult.isSuspiciousPhoto (boolean) - this values is intended to be null at this time from IDScan.net
- antiSpoofingVerificationResult (object) � All the test results related to the anti spoofing tests
- antiSpoofingVerificationResult.antiSpoofingFaceImageConfidence (int) this value represents how well the selfie image passed the verification checks that test whether or not the image is a real picture of someone's face. It is between 0 and 100 (inclusive) and we recommend using 70 as your threshold
- antiSpoofingVerificationResult.isDataFieldsTampered (boolean) this value represents if the data fields on the document were tampered with
- antiSpoofingVerificationResult.isPhotoFromDocumentTampered (boolean) this value represents if the face image on the document was tampered with
externalVerificationResults (array) � This array is populated will all external test results like the Address Verification, DMV checks and the Identifraud Check
authenticationResults (array) - This array is only populated with checks from the IDScan.net C# Authentication SDK
authenticationResults.name (string) - The name of the authentication test that was performed
authenticationResults.description (string) - A description of the authentication test that was performed
authenticationResults.response (string) - The response from the authentication test that was performed
authenticationResults.score (int) - The score from the authentication test that was performed. It is between 0 and 100 (inclusive) and we recommend using 70 as your threshold
requestData (object) (optional) - This object can be optionally populated to return the request data back to the application that submitted the request
images (object) (optional) - This object can be optionally populated to return the images that were submitted to the DIVE API as well as images that were cropped from those submitted those submitted images.