Skip to main content

Document Verification Codes and Meanings

This reference explains the docver_check.reasonCode values and related fields returned during Identity and Document Verification via the Cynopsis OCR & IDV APIs.

Document Types

The docver_check.document.type field indicates the type of document identified. Possible values include:
  • PASSPORT
  • ID_CARD – National identity cards
  • DRIVERS_LICENSE – Driver’s licenses
  • RESIDENCE_PERMIT – Residence permits and residence cards
  • VISA – Visa documents attached in a passport or issued as a separate document
  • OTHER – Other or unspecified document types

Verification Codes

During the verification process, your document undergoes multiple checks. The result is communicated in the verification object (e.g., docver_check.status and docver_check.reasonCode).
Use the tables below to interpret reason codes.

When docver_check.status is declined

CodeDescription
105Suspicious behaviour
112Restricted IP location
127Face match with blocklist
504Attempted deceit, device screen used
505Attempted deceit, printout used
508Presented document tampered, similarity to specimen

When docver_check.status is resubmission_requested

CodeDescription
608Document front missing
609Document back missing
614Document front not fully in frame
615Document back not fully in frame
619Document data not visible
620Presented document expired
621Document annulled or damaged
625Unable to collect surname
626Unable to collect first names
627Unable to collect date of birth
628Unable to collect issue date
629Unable to collect expiry date
630Unable to collect gender
631Unable to collect document number
632Unable to collect personal number
633Unable to collect nationality
634Unable to collect home address

Example

"docver_check": {
  "id": "8fd56097-caad-410b-8e57-fcaf24524007",
  "code": 9102,
  "person": { ... },
  "reason": "Presented document tampered, document similarity to specimen",
  "status": "declined",
  "document": {
    "type": "RESIDENCE_PERMIT",
    ...
  },
  "reasonCode": 508,
  ...
}
In the example above, reasonCode: 508 indicates the document was declined because it was tampered with or matched a known specimen/image.
If you need details for any additional status or reason codes not listed here, please contact support or refer to the full API documentation.