OCR Mismatch (ocr_match) Response Object

This JSON response is returned for a comparison of an OCR scan to the barcode or MRZ data.
👍
This response is returned by /get-results if you include the ocr_match signal in the /start endpoint.
{
  "ocr_match": {
    "type": "object",
    "description": "OCR mismatch signal (ocr_match) response",
    "properties": {
      "success": {
        "type": "boolean",
        "description": "True if the API call was successful; false otherwise."
      },
      "result": {
        "type": "boolean",
        "description": "True if data was returned in the data object; false otherwise."
      },
      "message": {
        "type": "string",
        "description": "A description of the result output, for example, \"success\" or an error message."
      },
      "data": {
        "type": "object",
        "description": "Contains the ocr_match signal elements returned as a JSON object.",
        "properties": {
          "isNameMatch": {
            "type": "boolean",
            "description": "True if name matched; false otherwise."
          },
          "nameMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isDocumentNumberMatch": {
            "type": "boolean",
            "description": "True if document number matched; false otherwise."
          },
          "documentNumberMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isCountryCodeMatch": {
            "type": "boolean",
            "description": "True if country code matched; false otherwise."
          },
          "countryCodeMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isExpirationDateMatch": {
            "type": "boolean",
            "description": "True if expiration date matched; false otherwise."
          },
          "expirationDateMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isDobMatch": {
            "type": "boolean",
            "description": "True if date of birth matched; false otherwise."
          },
          "dobMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isSexMatch": {
            "type": "boolean",
            "description": "True if sex matched; false otherwise."
          },
          "sexMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isNationalityMatch": {
            "type": "boolean",
            "description": "True if nationality matched; false otherwise."
          },
          "nationalityMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isIssuerNameMatch": {
            "type": "boolean",
            "description": "True if issuer name matched; false otherwise."
          },
          "issuerNameMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isAddressMatch": {
            "type": "boolean",
            "description": "True if address matched; false otherwise."
          },
          "addressMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isIssueDateMatch": {
            "type": "boolean",
            "description": "True if issue date matched; false otherwise."
          },
          "issueDateMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isHeightMatch": {
            "type": "boolean",
            "description": "True if height matched; false otherwise."
          },
          "heightMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isWeightMatch": {
            "type": "boolean",
            "description": "True if weight matched; false otherwise."
          },
          "weightMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isEyeColorMatch": {
            "type": "boolean",
            "description": "True if eye color matched; false otherwise."
          },
          "eyeColorMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isDlClassMatch": {
            "type": "boolean",
            "description": "True if driver license class matched; false otherwise."
          },
          "dlClassMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isDlEndorsementMatch": {
            "type": "boolean",
            "description": "True if driver license endorsement matched; false otherwise."
          },
          "dlEndorsementMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isDlRestrictionsMatch": {
            "type": "boolean",
            "description": "True if driver license restrictions matched; false otherwise."
          },
          "dlRestrictionsMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          },
          "isRealIdMatch": {
            "type": "boolean",
            "description": "True if real ID matched; false otherwise."
          },
          "realIdMatchDetails": {
            "type": "object",
            "description": "Contains `details` to explain the match decision along with a `similarityScore` value and a `similarityThreshold` value.",
            "properties": {
              "details": {
                "type": "string",
                "description": "A brief explanation of why a machine-learning decision found a match, a mismatch, or an indeterminate result."
              },
              "similarityThreshold": {
                "type": "number",
                "description": "A confidence cutoff that applies to `similarityScore`. For dates, this value is 100 because dates must be an exact match. Otherwise, this value is typically 80. The `similarityScore` must be greater than or equal to this `similarityThreshold` to produce a match. The match result determines a true or false value for the corollary object. For example, if this object is `nameMatchDetails`, then its corollary object is `isNameMatch`."
              },
              "similarityScore": {
                "type": "number",
                "description": "A confidence estimate between 0 and 100 that OCR data matched the barcode or the MRZ data."
              }
            }
          }
        }
      }
    }
  }
}
👍This response is returned by /get-results if you include the ocr_match signal in the /start endpoint.

👍
This response is returned by `/get-results` if you include the `ocr_match` signal in the `/start` endpoint.
