US Driver License PDF417 API

400 Bad Request - Invalid Input

{
  "success": false,
  "error": "INVALID_IMAGE",
  "message": "The uploaded image could not be decoded."
}

402 Payment Required - Insufficient Credits

{
  "success": false,
  "error": "INSUFFICIENT_CREDITS",
  "message": "Your account balance is insufficient to complete this operation. Top up at https://structocr.com/dashboard/billing",
  "top_up_url": "https://structocr.com/dashboard/billing"
}

413 Payload Too Large

{
  "success": false,
  "error": "FILE_TOO_LARGE",
  "message": "The image exceeds the 4.5MB limit."
}

415 Unsupported Media Type

{
  "success": false,
  "error": "UNSUPPORTED_FILE_FORMAT",
  "message": "Supported formats are JPG, PNG and WebP."
}

422 Unprocessable Entity - PDF417 Not Detected

{
  "success": false,
  "error": "PDF417_NOT_DETECTED",
  "message": "No PDF417 barcode was detected in this image. Retake the photo.\nPhotograph the barcode on the back of the license, not the whole card:\n1. Move close so the entire barcode fills most of the frame, leaving a small clear margin on all four sides. Do not crop any edges.\n2. Hold the phone steady, face the barcode straight-on, and tap on the barcode to focus until the bars look sharp.\n3. Avoid glare and shadows over the barcode.\n4. Upload the original camera photo, not a screenshot or a copy compressed by a chat app.\nIf this is the front of the license, read it with Driver License OCR instead: API /v1/driver-license, or the web tool at structocr.com/tools/driver-license-scanner.",
  "capture_issue": "unknown"
}

422 Unprocessable Entity - PDF417 Not Decoded (blurry barcode)

{
  "success": false,
  "error": "PDF417_NOT_DECODED",
  "message": "The PDF417 barcode area is too blurry to read. Retake the photo focused on the barcode.\nPhotograph the barcode on the back of the license, not the whole card:\n1. Move close so the entire barcode fills most of the frame, leaving a small clear margin on all four sides. Do not crop any edges.\n2. Hold the phone steady, face the barcode straight-on, and tap on the barcode to focus until the bars look sharp.\n3. Avoid glare and shadows over the barcode.\n4. Upload the original camera photo, not a screenshot or a copy compressed by a chat app.",
  "capture_issue": "out_of_focus"
}

422 Unprocessable Entity - Invalid AAMVA

{
  "success": false,
  "error": "AAMVA_NOT_VALID",
  "message": "The barcode was decoded, but its data could not be validated as a supported AAMVA driver license record."
}

502 Bad Gateway - Decoder Error

{
  "success": false,
  "error": "PDF417_UPSTREAM_ERROR",
  "message": "The PDF417 decoder could not process the request. Please try again."
}

502 Bad Gateway - Invalid Decoder Response

{
  "success": false,
  "error": "PDF417_INVALID_RESPONSE",
  "message": "The PDF417 decoder returned an invalid response. Please try again."
}

503 Service Unavailable

{
  "success": false,
  "error": "PDF417_SERVICE_UNAVAILABLE",
  "message": "The PDF417 decoder is temporarily unavailable. Please try again later."
}