When you send a job to the API, a lot of things happen behind the scenes: we get the input files, we validate them, we try to understand which kind of files they are and finally we start the conversion giving back to you the converted file(s).
During this process, something can go wrong either by your side (e.g. a wrong URL for a remote input or a password protected file) or by our side (e.g. we cannot convert yet a particular file format).
If an error condition is detected, the API reports it to you using the errors and warnings arrays inside the JSON responses. This means that for a single job you can receive more than one error or warning.
The errors are conditions that lead to a failed conversion.
The warnings are conditions that lead to a successful conversion but for some reason, it might not be as expected or contain minor issues.
Following is an example of a failed conversion with two input errors inside:
"status": {
"code": "failed",
"info": "The file has not been converted due to errors."
},
"errors": [
{
"source": "input",
"id_source": "4ebe940f-7e20-4b5e-9bc1-cdaa5675e3eb",
"code": 401,
"message": "The file could not be downloaded by our servers, because a password has been requested to access the data."
},
{
"source": "input",
"id_source": "ed5c51d7-a2d0-4a93-ac8f-8c58e4af604b",
"code": 404,
"message": "The file could not be downloaded by our servers. Please verify the link you have provided."
}
]
As you can see, there are always four fields:
Following is an example of a failed conversion with one conversion error inside:
"status": {
"code": "failed",
"info": "The file has not been converted due to errors."
},
"errors": [
{
"source": "conversion",
"id_source": "d9e5b86b-7faa-4048-8cdf-3593b1d3a8bd",
"code": 6005,
"message": "Your file is missing important meta data and we therefore can not convert it."
}
]
| Code | Message | Notes |
|---|---|---|
| 2 | The job can not be modified. | Only jobs with status incomplete or ready can be modified. |
| 5 | Empty or invalid file received. | The remote or locally uploaded file was empty or corrupted. Please try again. |
| 34 | The total inputs' file size for a conversion has been exceeded and your file discarded. | If you need more power, please upgrade your contract. |
| Code | Message | Notes |
|---|---|---|
| 1 | The file could not be downloaded. We are unable to resolve the host address or the host is unreachable. | |
| 10 | We are not authorized to download Youtube videos. | |
| 11 | We are not authorized to download metadata from the provided URL. | |
| 12 | We are not authorized to download embedded contents from the provided URL. | |
| 13 | The file specified was not found. | Specific for cloud services. |
| 15 | The server where we wanted to download the file is currently not available. | Specific for Amazon S3. |
| 16 | We cannot download the file, are you sure the specified region is the one of your bucket? | Specific for Amazon S3. |
| 17 | File not found, reasons for this error could be: bucket has incorrect permissions, you sent invalid credentials, or the file is really not there. | Specific for Amazon S3. |
| 18 | The token is invalid or has expired. | Specific for Amazon S3. |
| 19 | We could not connect to google cloud, are you sure that all credentials are correct? | Specific for Google Cloud. |
| 20 | We could not connect to azure, are you sure that all credentials are correct? | Specific for Azure. |
| 21 | The specified file was not found. | Specific for Azure. |
| 22 | There was an error that we could not recover, if this problem persists please contact support. | Specific for Azure. |
| 23 | The specified container does not exist. | Specific for Azure. |
| 24 | Azure could not authenticate the request, make sure that your accountkey credential is valid. | Specific for Azure. |
| 25 | Could not connect to FTP server, are you sure all connection parameters and credentials are correct? | Specific for remote FTP download. |
| 26 | There was an error that we could not recover, if this problem persists please contact support. | Specific for remote FTP download. |
| 27 | Could not login to the FTP server with the given credentials, are the credentials correct? | Specific for remote FTP download. |
| 28 | The FTP host cannot be resolved, are you sure it is correct? | Specific for remote FTP download. |
| 29 | The file specified was not found in the FTP server. | Specific for remote FTP download. |
| 33 | The file cannot be downloaded. Unknown input_id or missing credentials. | |
| 39 | The AWS Access Key Id you provided does not exist. | |
| 50 | The file could not be downloaded by our servers. You do not have permissions to convert files of this size. Please upgrade your account. | |
| 51 | The file could not be downloaded by our servers, because the host answered: Daily Limit for Unauthenticated Use Exceeded. | |
| 52 | The file could not be downloaded by our servers, because the host answered: The download quota for this file has been exceeded. | |
| 401 | The file could not be downloaded by our servers, because a password has been requested to access the data. | |
| 402 | The file could not be downloaded by our servers, because a payment was required. | |
| 403 | The file could not be downloaded by our servers, because a password has been requested to access the data. | |
| 404 | The file could not be downloaded by our servers. Please verify the link you have provided. | |
| 408 | The file could not be downloaded by our servers, because the remote server timed out. | |
| 410 | The file could not be downloaded by our servers, because the link you have provided does not exists anymore. | |
| 413 | The file could not be downloaded by our servers, because the file size is too big. | |
| 414 | The file could not be downloaded by our servers, because the URI you have provided it is too long. | |
| 429 | The file could not be downloaded by our servers, because the remote server is too busy. Please try again later. | |
| 451 | The file could not be downloaded by our servers, because the remote resource it is unavailable for legal reasons. | |
| 500 | The server where we wanted to download the file is currently not available. | |
| 503 | The file could not be downloaded. We are unable to resolve the host address or the host is unreachable. | |
| 504 | The file could not be downloaded by our servers, because the remote server timed out. | |
| 509 | The file could not be downloaded by our servers, because the remote server reached its bandwidth limit. Please try again later. | |
| 511 | The file could not be downloaded by our servers, because a network authentication is required to reach the requested resource. |
| Code | Message | Notes |
|---|---|---|
| 19 | We cannot upload the file, are you sure the specified region is the one of your bucket? | Specific for Amazon S3. |
| 20 | The server where we wanted to upload the file is currently not available. | Specific for Amazon S3. |
| 21 | A file with this name already exists in the cloud storage. | |
| 22 | Problem uploading file to cloud storage, if this problem persists, please contact support. | |
| 23 | We could not connect to azure, are you sure that all credentials are correct? | Specific for Azure. |
| 24 | Problem uploading file to cloud storage, if this problem persists, please contact support. | Specific for Azure. |
| 25 | There was an error that we could not recover, if this problem persists please contact support. | Specific for Azure. |
| 26 | Azure could not authenticate the request, make sure that your accountkey credential is valid. | Specific for Azure. |
| 27 | The specified container does not exist. | Specific for Azure. |
| 28 | Please make sure that all the parameters required for this operation are correct, check the api documentation. | The JSON you sent to us is wrong or is missing important data. |
| 29 | Could not connect to FTP server, are you sure all connection parameters and credentials are correct? | Specific for remote FTP upload. |
| 30 | There was an error that we could not recover, if this problem persists please contact support. | Specific for remote FTP upload. |
| 31 | Could not login to the FTP server with the given credentials, are the credentials correct? | Specific for remote FTP upload. |
| 32 | The FTP host cannot be resolved, are you sure it is correct? | Specific for remote FTP upload. |
| 34 | The total inputs file size for a conversion has been exceeded and your file discarded. | You cannot convert the file because it is too big. You need to upgrade your contract. |
| 35 | We could not connect to youtube, are you sure that all credentials are correct? | Specific for YoutTube upload. |
| 36 | Problem uploading file to gdrive, if this problem persists, please contact support. | Specific for Google Drive upload. |
| 37 | Permission denied while trying to write file to FTP server. | Specific for remote FTP upload. |
| 38 | Problem uploading file to cloud storage, if this problem persists, please contact support. |
| Code | Message | Notes |
|---|---|---|
| 2 | The job can not be modified. | The job status does not allow any new input. |
| 3 | You reached maximum allowed file size in upload. | You cannot convert the file because it is too big. You need to upgrade your contract. |
| 4 | The job input limit has been reached. | The job cannot accept more inputs for your kind of contract. |
| 5 | Empty or invalid file received. | |
| 6 | Problem uploading file. | |
| 7 | Job not found. | |
| 8 | Problem uploading file: Unsupported Content-Range header. | You are not using the correct header for chunk upload. |
| 34 | The total inputs file size for a conversion has been exceeded and your file discarded. | You cannot convert the file because it is too big. You need to upgrade your contract. |
| 39 | The total number of inputs set for a conversion has been exceeded and your file discarded. | The job cannot accept more inputs for your kind of contract. |
| Code | Message | Notes |
|---|---|---|
| 6000 | There has been an error converting your file. | Default conversion error code. We are not able to tell more. Please send us a ticket request. |
| 6001 | Your file is DRM protected and we therefore are not allowed to convert it. | |
| 6002 | The file is password protected. Please, provide the password. | |
| 6003 | The file can not be converted because the bitrate is set too low. Please set a higher bitrate or, in case you are converting a video, reduce the frame rate or decrease width and height of the video. | |
| 6004 | Unfortunately we can not convert your file yet from your source file format to this target file format. | If you feel that this format should be added, please let us know! |
| 6005 | Your file is missing important meta data and we therefore can not convert it. | E.g. the moov atom is missing. |
| 6006 | The files inside an archive must be of the same type. | E.g. you sent a ZIP with both JPGs and PNGs inside. |
| 6007 | To crop an image you have to specify a value for ALL of the followings: crop_origin_x, crop_origin_y, crop_width, crop_height. | |
| 6008 | To specify a custom page size, ALL of the following parameters must have a valid value: custom_page_size_width, custom_page_size_height, custom_page_size_unit. | |
| 6009 | Out of range pages for the requested conversion. Please, check that the passed page numbers in the parameters are within the document limits. | |
| 6010 | Not enough data to start the conversion. Please, check all the parameters. | |
| 6011 | We are not able to use the provided password to decrypt the file. | |
| 6012 | There was a temporary error with your conversion. Please try again later. | We had a problem on our side. Normally it is auto fixed in a few seconds. |
| 6013 | To crop a video you have to specify a value for ALL of the followings: crop_origin_x, crop_origin_y, crop_width, crop_height. | |
| 6014 | None of the conversions finished successfully. | |
| 6015 | The job input limit has been reached. | |
| 6016 | Too few files to execute the requested conversion. | |
| 6017 | Too many files to execute the requested conversion. | |
| 6018 | The file seems to be broken and we are unable to fix it. | |
| 6019 | Your file uses an unsupported encryption format. | |
| 6020 | Your conversion took too long and was canceled. | |
| 6021 | Width or height exceed the limit for icons. Please make sure the largest side is set to max 256px. | |
| 6022 | There has been an error converting your file. | |
| 6023 | The job has an input file which is too old. | |
| 6024 | We could not compress this file any further. | |
| 6025 | Unfortunately, during conversion we detected an issue. Probably you set wrong values for bitrate, width or height. Try changing values or select a different codec if available. | |
| 6026 | Width or height exceed the limit for AI upscaling. Please make sure the largest side is set to max 2000px. | |
| 6027 | Unsupported input file format for the requested conversion. | |
| 6028 | Unsupported output file format for the requested conversion. | |
| 6029 | The input file is not a valid PDF. | |
| 6030 | All slides in the presentation are marked as hidden. | |
| 6031 | The input file cannot be converted to the selected PDF/A standard. | |
| 6032 | The input file cannot be converted to the selected PDF/A standard. Probably the original PDF contains errors that we cannot automatically fix. | |
| 6033 | The input file cannot be converted to the selected PDF/A standard. | |
| 6034 | Strict mode cannot be used via API. | |
| 6035 | The input file cannot be converted to the selected PDF/A standard. | |
| 6036 | We are not able to extract any embedded assets from the file. | |
| 6037 | The values for width or height are too large. Please try again with smaller values. | |
| 6038 | The resulting duration of the converted video is too long (>4 hrs). | |
| 6039 | Please, retry the conversion without the OCR option. | |
| 6040 | Some data is missing. | |
| 6041 | Unknown audio channels layout. | |
| 6042 | Input filter name is missed or unknown. | |
| 6043 | Input id is missed or unknown. | |
| 6044 | Volume value is missed. | |
| 6045 | You cannot set an audio channels layout and filtering at the same time. Please, split it in two separate jobs. | |
| 6046 | The input file is not compliant with the selected PDF/A validation profile. | |
| 6047 | There has been an error validating your file. | |
| 6048 | Please, retry the conversion without the OCR option. | |
| 6049 | Please, retry the conversion with the OCR option. | |
| 6051 | There has been an error converting your file. | |
| 6052 | We could not extract any text from your file. | |
| 6053 | We could not extract any audio from your file. | |
| 6054 | AI upscale cannot be used to downscale an image. | |
| 6056 | We are not able to extract any embedded assets from this file format yet. | |
| 6057 | The input file cannot be converted to the selected PDF/A standard while in non-strict mode. | |
| 6058 | AI upscale percentage out of range. It should be between 101 and 400. | |
| 6059 | Missing mandatory prompt. | |
| 6060 | NSFW content detected. | |
| 6061 | The images have different aspect ratio. | |
| 6062 | We could not extract any text from your file. Have you specified the main language of your audio? | |
| 6063 | Missing mandatory image file. | |
| 6064 | There has been an error converting your file. | |
| 6065 | There has been an internal error while converting your file. |
| Code | Message | Notes | |
|---|---|---|---|
| 20000 | Unfortunately, we detected an issue during conversion. We converted your file as best as possible, but it might be only converted partly. Please check it manually. | Probably something happened during the conversion but we are unable to tell more. Often this results in a usable file nonetheless. | |
| 20001 | Impossible to write metadata inside the file. | Some of the requested metadata were not written inside the converted file. | |
| 20002 | Cannot write metadata. | Some of the requested metadata were not written inside the converted file. | |
| 20003 | Unfortunately, we can not yet convert your file from your source file format to this target file format. | ||
| 20004 | The rendered output may be incorrect. | ||
| 20005 | Your file uses an unsupported encryption format. | ||
| 20006 | The DPI value may be incorrect. | ||
| 20007 | We could not compress this file any further. | ||
| 20008 | The version of the converted file has been downgraded. | ||
| 20009 | It was not possible to preserve transfer functions in PDF 2.0. | ||
| 20010 | The selected language was not found. Text detection can be incorrect. | ||
| 20011 | The value for the audio frequency is too low. The conversion used the lowest possible value allowed. You can also try again with a higher value or with a different codec. | ||
| 20012 | The value for the audio frequency is too high. The conversion used the highest possible value allowed. You can also try again with a smaller value or with a different codec. | ||
| 20013 | The value for the audio frequency is not allowed. The conversion used the highest possible value allowed. You can also try again with another value or with a different codec. | ||
| 20014 | The sizes of the reference image and the compared image do not match. The result can be inaccurate. | ||
| 20015 | The sizes of the reference video and the compared video do not match. The result can be inaccurate. | ||
| 20016 | The codecs of the input files does not fit the video codec. A different one was chosen. | ||
| 20017 | The model and the upscale factor chosen failed the conversion. A different combination was automatically chosen. | ||
| 20018 | The width or height exceed the limit for AI upscaling for your file. The maximum possible size is provided. | ||
| 20019 | The requested voice is not available for your language. The default gender was used. | ||
| 20020 | The requested style cannot be applied for an unexpected error. | ||
| 20021 | The requested style was not found. | ||
| 20022 | During compression we detected a larger quality degradation. Please check the result. |