Response messages

The messages array in the API response contains human-readable explanations for integrators. Messages appear when verification behaved unexpectedly or could not produce a complete result.

Each message has a Code and a Message string. Codes are prefixed by type: E (error), W (warning), or I (informational).

Errors

E001

The request produced no result. Review your request parameters and ensure the required image fields are present and valid.

E003

Text extraction from the document failed entirely. Supply higher-quality images with all document edges visible and no cropping.

Warnings

W001

The front image was marginal quality, but processing continued and produced a partial result. Review processIndicators for details on what affected the image. If the result is inadequate, prompt the user to recapture.

W002

Image quality was too low for any reliable result. Prompt the user to recapture.

W003

Only one image was provided for a multi-sided document. Supplying the other side will produce a more complete and reliable verification.

W004

The barcode image quality was insufficient. If submitting a separate barcode image, supply a higher-quality capture.

W005

Image quality prevented the system from reaching a fraud verdict. recommendedOutcome will be Retry. Prompt the user to recapture.

W006

The image lacks sufficient clarity. Prompt the user to recapture with better lighting and focus.

W007

The document is so close to the image edges that liveness checks could not run, and no overall fraud verdict is possible. Prompt the user to recapture with more background visible around the document. If you are intentionally submitting cropped images, see Accept cropped images.

W008

The document is close to the image edges; verification ran but the liveness check was skipped. The fraud verdict is less reliable as a result. Prompt the user to recapture if possible. If you are intentionally submitting cropped images, see Accept cropped images.

Informational

I001

Processing completed and all feasible checks ran. If the result is not what you expected, review processIndicators for details on conditions that may have limited the checks.