Error Responses

Below is a list of possible Veryfi REST API error codes and messages. Each endpoint section (e.g. https://docs-dev.veryfi.com/api/receipts-invoices/process-a-document/) contains a more comprehensive list under Responses.

Veryfi HTTP API Error Responses

Errors codes are returned in the standard HTTP format. Any additional information is included in the JSON-formatted body of the response.

Status Code	Message	Possible Cause	Possible Solution
400	File is corrupted.	Invalid image.	Confirm that the image sent for processing is not corrupted.
400	The file type is not supported for this endpoint.	The image sent for processing is unsupported by the product.	Confirm in the documentation that the file meets the requirements for the product
400	Couldn't download file from provided url.	Invalid url.	Confirm that the provided image URLs are valid and publicly accessable.
400	Received empty or missing data.	The file may be too big, empty, or not found.	Confirm in the documentation that the file meets the requirements for the product.
400	Missing or bad parameters / malformed parameters.	Missing one or more of the parameters, for example: id file file_date file_url file_urls package_path and must be applied.	Check the details object response for the specific parameter that is missing.
401	Not Authorized	Request failed to get authenticated.	Confirm that you have successfully authenticated with the Veryfi API.
403	This action is only allowed to company admins.	The credentials used do not have correct access permissions.	Reach out to your account owner to confirm that you have the correct access type credentials to perform the attempted request.
403	This action is not allowed.	Creating an HTTP Request using an unsupported verb on a resource such as A PUT request on /Checks	Confirm in the documentation that you are performing the correct request on the endpoint.
429	Too many bad requests.	Exceeded request quota.	See rate limits and throttling documentation to learn more.
500	Failed to process documents.	The image submitted for upload may be invalid.	Confirm in the documentation that the file meets the requirements for the product.
503	Service temporarily unavailable, try again later.	Service or particular endpoint may be under maintenance.	Check Veryfi's Status page for updates.