Get the list of your active contracts

Overview of the error and warning system

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."
    }
]

Example of a failed conversion

As you can see, there are always four fields:

  • "source": can be either input or conversion
  • "id_source": contains the id of the input or the conversion it is referring to. You can find the details about the input or the conversion in the same JSON response
  • "code": a unique numerical error code. If you plan on automatically reacting to an error or a warning, you have to check the code, not the message, because this can change at any time, while the code will stay the same
  • "message": a human readable explanation of the received error code. Be aware that this message can change at any time in the future, so always use the code

Sometimes an additional "details" field is filled with more useful information

Following is an example of a failed conversion with one conversion error inside and more detailed info:


"status": {
    "code": "failed",
    "info": "The file has not been converted due to errors."
},
"errors": [
    {
        "source": "conversion",
        "idSource": "2ec94b7f-c90e-412f-af2b-77adc2638745",
        "code": 6037,
        "message": "The values for width or height are too large. Please try again with smaller values.",
        "details": {
            "text_1": "The requested DPI and width/height values exceed the max allowed of %max_allowed_size%",
            "units": "cm",
            "max_allowed_size": 1794,
            "requested_max_size": 5000
        }
    }
]

List of common errors

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.
6066 Unable to generate a thumbnail from the provided input file.
6067 We could not detect any faces in your file.

Common conversion warnings

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.
20023 The original input file frame rate or the user selected frame rate is not compatible with the used video codec. A default compatible frame rate was used instead.
20024 The conversion may result in excessively loud audio, which can be harmful to your hearing and damage speakers or headphones.
20025 We could not compress this file any further. Target file size not reached.