Error Responses
Below is a full list of all possible Veryfi REST API error codes and messages.
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. You can also check the FAQ for file requirements and supported file types. |
400 | Couldn't download file from provided url. | Invalid url. | Confirm that the provided image URLs are valid and publicly addressable. |
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. You can also check the FAQ for file requirements and supported file types. |
400 | Missing or bad parameters / malformed parameters. | Missing one or more of the following parameters:
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 partner making the request does not meet the access type requirements to perform this action. | Reach out to your account owner to confirm that you have the correct access type credentials to perform the attempted request. |
403 | CLIENT-ID header is missing. | CLIENT-ID is missing in the request header. | Add the correct CLIENT-ID to your request header. Confirm that you have successfully authenticated with the Veryfi API. |
403 | This action is not allowed. | Creating an HTTP Request using an unsupported verb on a resource such as | 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. You can also check the FAQ for file requirements and supported file types. |
503 | Service temporarily unavailable, try again later. | Service may be under maintenance. | Confirm in the documentation that the file meets the requirements for the product. You can also check the FAQ for file requirements and supported file types. |
Please sign up for any outage notifications on Veryfi Status Page.