Factuarea APIDevelopers
Contract

Purchase scans: unavailable source error

Retry, convert and restore now identify when the original scan file is no longer retained.

27 September 2026 — POST /purchase_scans/{purchase_scan}/retry, POST /purchase_scans/{purchase_scan}/convert and POST /purchase_scans/{purchase_scan}/restore can return HTTP 422 with error.code: purchase_scan_source_unavailable and error.subcode: source_unavailable when the original file has been purged or is no longer available in secure storage.

The scan history remains available. To process the document again, upload another copy of the original. The request fields and URLs have not changed.

Updated endpoints3

EndpointDescription
POST/v1/purchase_scans/{purchase_scan}/retryRetry a failed purchase scan
POST/v1/purchase_scans/{purchase_scan}/convertCreate the expense from a scan
POST/v1/purchase_scans/{purchase_scan}/restoreRestore an archived purchase scan