Verification/Authentication Response

{
  "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "document": {
    "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",
    "maidenName": "string",
    "middleName": "string",
    "placeOfBirth": "string",
    "postalBox": "string",
    "state": "string",
    "issuedBy": "string",
    "weight": "string",
    "zip": "string",
    "cardRevisionDate": "string",
    "hazmatExpirationDate": "string",
    "race": "string",
    "ssn": "string",
    "suffix": "string"
  },
  "documentVerificationResult": {
    "isDocumentExpired": true,
    "isOcrSuccess": true,
    "isPdf417Success": true,
    "isMrzSuccess": true,
    "isShuftiSuccess": true,
    "isDriversLicenseRealID": true,
    "isDriveOnly": true,
    "isVeteran": true,
    "isDonor": true,
    "isLimitedDurationDocument": true,
    "isInvalidated": true,
    "documentConfidence": 0
  },
  "faceMatchVerificationResult": {
    "falseAcceptanceRate": 0,
    "faceMatchConfidence": 0,
    "isAgeCheckSuccess": true,
    "isGenderCheckSuccess": true,
    "assessedAgeFromSelfie": 0,
    "assessedAgeFromDocument": 0,
    "isSuspiciousPhoto": true
  },
  "antiSpoofingVerificationResult": {
    "antiSpoofingFaceImageConfidence": 0,
    "isDataFieldsTampered": true,
    "isPhotoFromDocumentTampered": true
  },
  "externalVerificationResults": [
    {
      "name": "string",
      "displayName": "string",
      "reason": "string",
      "effect": 0,
      "values": [
        {
          "score": 0,
          "effect": 0,
          "fieldName": "string",
          "priority": 0
        }
      ],
      "status": 0
    }
  ],
  "authenticationResults": [
    {
      "name": "string",
      "description": "string",
      "response": "string",
      "score": 0
    }
  ],
  "requestData": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "documentType": 1,
    "requestIpAddress": "string",
    "geolocation": {
      "continentCode": "string",
      "continent": "string",
      "countryCode": "string",
      "country": "string",
      "stateCode": "string",
      "state": "string",
      "city": "string",
      "postCode": "string",
      "accuracyRadius": 0,
      "latitude": 0,
      "longitude": 0,
      "timeZone": "string",
      "network": "string"
    },
    "trackString": {
      "data": "string",
      "barcodeParams": "string"
    },
    "metadata": {
      "captureMethod": "string",
      "userAgent": "string",
      "frontEndMetadata": "string",
      "otherMetadata": "string"
    },
    "settings": {
      "isOCREnabled": true,
      "isCrossMatchRequired": true,
      "isGenderCheckEnabled": true,
      "isAgeCheckEnabled": true,
      "isDocTypeChangeEnabled": true,
      "isExternalOFACWatchlistEnabled": true,
      "ageYearsDifference": 0,
      "submissionDaysCount": 0,
      "bothSidedScreeningStrategy": 0,
      "oneSidedScreeningStrategy": 0,
      "isExternalAddressVerificationEnabled": true,
      "isExternalShuftiEnabled": true,
      "isFaceMatchOptional": true,
      "isBackOrSecondImageProcessingEnabled": true,
      "isFaceMatchEnabled": true
    }
  },
  "images": {
    "frontImage": "string",
    "backOrSecondImage": "string",
    "frontImageUv": "string",
    "backOrSecondImageUv": "string",
    "frontImageIr": "string",
    "backOrSecondImageIr": "string",
    "faceImage": "string",
    "croppedFaceImage": "string",
    "croppedFaceImageFromDocument": "string",
    "signatureImage": "string"
  },
  "transactionData": {
    "updateDate": "2024-10-16T17:16:50.257Z",
    "remainingAmount": 0
  },
  "reference": "string"
}

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

  • 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)
  • 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)
  • documentVerificationResult.isInvalidated (boolean)
  • 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.isAgeCheckSuccess (boolean) this value represents if the age of the person in the image on the front of the document is within 10 years of the person in the selfie
  • faceMatchVerificationResult.isGenderCheckSuccess (boolean) this value represents if the gender of the person in the image on the front of the document is the same as the gender of the person in the selfie
  • faceMatchVerificationResult.assessedAgeFromSelfie (int) this is the approximate age DIVE has assessed the person in the selfie image is at the time of the photo
  • faceMatchVerificationResult.assessedAgeFromDocument (int) this is the approximate age DIVE has assessed the person in the document photo image is when the document photo was taken
  • faceMatchVerificationResult.isSuspiciousPhoto (boolean)
  • 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 when submitting images to the Authentication service.

  • 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.