document_unreadable (422)

← Error reference

document_unreadable

HTTP status: 422

Retryable: No — retrying without changes will fail the same way.

The uploaded document image could not be read by the ID scan API.

When it fires

A `POST /v1/id-verification` request supplied an image the ID scan API could not recognize — too blurry, cropped, glare-obscured, low-resolution, or not a supported document. The response carries `details.recognition_status: "FAILURE"` and the `dvc_…` call id for correlation. An unreadable document is not charged.

How to handle it

Capture a clearer, well-lit, in-focus image of the full document and submit again. This is not a transient error — an identical retry of the same image yields the same result, so re-prompt for a better capture rather than retrying the same bytes.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/document_unreadable",
    "code": "document_unreadable",
    "message": "The document could not be read. Provide a clearer image.",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/document_unreadable",
    "details": {
      "recognition_status": "FAILURE",
      "id": "dvc_01HEXAMPLE0000000000000000"
    }
  }
}