Skip to main content
POST
/
service
/
v2
/
ocr
Perform OCR and IDV
curl --request POST \
  --url https://d1.cynopsis.co/service/v2/ocr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Domain-Id: <x-domain-id>' \
  --form file0=@example-file \
  --form file1=@example-file
{
  "task_id": "b1259f10-1c4e-42d2-b96e-7f553d87c345",
  "status_task": "SUCCESS",
  "result": {
    "last_name": "LEE",
    "first_name": "MICHAEL",
    "full_name": "MICHAEL LEE",
    "full_name2": "LEE MICHAEL",
    "gender": "M",
    "race": "ASIAN",
    "date_of_birth": "1983-11-19",
    "domicile": "SINGAPORE",
    "address": "123 JURONG WEST, SINGAPORE",
    "passport_number": "E8573920N",
    "document_number": "A0123456",
    "personal_id_number": "S3344556D",
    "issuing_country": "MALAYSIA",
    "country_of_birth": "MALAYSIA",
    "nationality": "MALAYSIAN",
    "passport_expiry_date": "2028-12-10",
    "expiry_date": "2028-12-31",
    "issue_date": "2023-01-05",
    "optional_data": null,
    "profession": "ENGINEER",
    "birth date": "1983-11-19",
    "expiry date": "2028-12-31",
    "mrz_raw_string": "IDMYS3344556D8301196M2812319<<<<<<<<<<<<<<04",
    "identifier": "U0987654",
    "employer": "Acme Corp",
    "status": "UNCERTAIN",
    "document_type": "PASSPORT",
    "document_type_name": "INTERNATIONAL PASSPORT",
    "valid genre format": "true",
    "final hash": "true",
    "expiry date hash": "true",
    "optional data hash": "true",
    "document type format": "true",
    "valid country code": "true",
    "valid nationality code": "true",
    "document number hash": "true",
    "birth date hash": "true",
    "document number format": "true",
    "optional data format": "true",
    "docver_check": {
      "id": "02f54862-c9ba-4a82-abde-c22183f362e1",
      "code": 8899,
      "person": {
        "gender": "M",
        "idNumber": "S3344556D",
        "lastName": "LEE",
        "addresses": [
          "123 JURONG WEST, SINGAPORE"
        ],
        "firstName": "MICHAEL",
        "citizenship": "MALAYSIAN",
        "dateOfBirth": "1983-11-19",
        "nationality": "MALAYSIAN",
        "yearOfBirth": 1983,
        "placeOfBirth": "KUALA LUMPUR",
        "pepSanctionMatch": false
      },
      "reason": "All document features match specimen.",
      "status": "approved",
      "comments": [
        "Verified by automated system."
      ],
      "document": {
        "type": "PASSPORT",
        "state": "VALID",
        "number": "A0123456",
        "country": "MY",
        "validFrom": "2023-01-05",
        "validUntil": "2028-12-31"
      },
      "attemptId": "a777aaf8-5daf-498c-ada0-c9121f3aaa2f",
      "endUserId": "user-99123",
      "reasonCode": 100,
      "vendorData": "Extra info",
      "decisionTime": "2026-02-13T09:05:20.105392Z",
      "acceptanceTime": "2026-02-13T09:05:10.388182Z",
      "submissionTime": "2026-02-13T09:05:11.222100Z",
      "additionalVerifiedData": {},
      "recommendation": ""
    },
    "ignored_fields": []
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Domain-Id
string
required

Domain ID

Body

multipart/form-data
​
file0
file
required

Main document image file

​
file1
file

(Optional) Second document image file (back, if required)

Response

OCR and IDV Result

The response is of type object.